axross · PyPI
Skip to main content<br>Switch to mobile version
Warning
You are using an unsupported browser, upgrade to a newer version.
Warning
Some features may not work without JavaScript. Please try enabling it if you encounter problems.
Search PyPI
Search
axross 0.6.0
pip install axross
Copy PIP instructions
Latest release
Released:<br>Jun 11, 2026
A multi-protocol file manager, scripting surface, and MCP server built with PyQt6
Navigation
Verified details
These details have been verified by PyPI<br>Maintainers
marcolux
Unverified details
These details have not been verified by PyPI<br>Project links
Documentation
Homepage
Issues
Repository
Meta
License Expression: Apache-2.0
SPDX<br>License Expression
Author: Marco Lux
Tags
file-manager
sftp
smb
webdav
s3
mcp
multi-protocol
Requires: Python >=3.10
Provides-Extra:<br>smb<br>, webdav<br>, s3<br>, azure<br>, onedrive<br>, gdrive<br>, dropbox<br>, fuse<br>, winrm<br>, wmi<br>, exchange<br>, adb<br>, archive<br>, tftp<br>, postgres<br>, redis<br>, mongo<br>, git<br>, dns<br>, magic<br>, encoding<br>, snmp<br>, ldap<br>, mac<br>, whois<br>, ntp<br>, all
Classifiers
Development Status
4 - Beta
Environment
X11 Applications :: Qt
Intended Audience
End Users/Desktop
System Administrators
Operating System
MacOS
Microsoft :: Windows
POSIX :: Linux
Programming Language
Python :: 3
Python :: 3 :: Only
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14
Topic
Communications :: File Sharing
System :: Filesystems
Utilities
Report project as malware
Project description
Axross
One UI for 30+ file, cloud, network, legacy, database, scripting,<br>and MCP workflows.
Axross is a multi-protocol file manager and security toolkit built<br>with Python and PyQt6. It gives you a split-pane desktop UI, a<br>headless MCP server mode for LLM agents, and a public axross.*<br>Python scripting API from the same package.
The project is currently beta: useful, broad, and actively hardened,<br>but still moving quickly.
Install
Base install:
python -m venv .venv<br>source .venv/bin/activate<br>pip install axross<br>axross
Install the common light protocol extras:
pip install "axross[all]"
Pick individual extras when you only need selected backends:
pip install "axross[smb]" # SMB / CIFS + DFS-N<br>pip install "axross[s3]" # S3-compatible storage<br>pip install "axross[webdav]" # WebDAV<br>pip install "axross[gdrive]" # Google Drive<br>pip install "axross[dropbox]" # Dropbox<br>pip install "axross[postgres]" # PostgreSQL-as-FS<br>pip install "axross[redis]" # Redis-as-FS<br>pip install "axross[mongo]" # MongoDB GridFS<br>pip install "axross[git]" # Git-as-FS via dulwich
Heavy or platform-sensitive extras stay explicit:
pip install "axross[winrm]"<br>pip install "axross[wmi]"<br>pip install "axross[exchange]"<br>pip install "axross[fuse]"
On minimal Debian/Ubuntu containers, install Qt loader libraries before<br>launching the GUI:
apt-get update<br>apt-get install -y --no-install-recommends \<br>libglib2.0-0 libgl1 libegl1 libfontconfig1 libxkbcommon0 libdbus-1-3
Headless modes (--help, --script, --mcp-server) work without<br>those GUI libraries.
First Checks
axross --version<br>axross --help<br>python -m axross --help<br>python -<br>import axross<br>print(axross.__version__)<br>print(axross.localfs().list_dir(".")[:3])<br>PY
Launch modes:
axross # desktop GUI<br>axross --script script.py # run an axross automation script<br>axross --mcp-server # stdio MCP server for local agents<br>axross --mcp-server --mcp-http 127.0.0.1:7331
What It Can Talk To
Core backends include SFTP/SCP, FTP/FTPS, SMB/CIFS, WebDAV,<br>S3-compatible storage, Rsync, NFS, Azure Blob/Files, OneDrive,<br>SharePoint, Google Drive, Dropbox, iSCSI, IMAP, POP3, TFTP,<br>Telnet, WinRM, WMI/DCOM, Exchange, DFS-N, ADB, MTP, Gopher,<br>NNTP/Usenet, SQLite-FS, PostgreSQL-FS, Redis-FS, MongoDB GridFS,<br>Git-as-FS, PJL printer-FS, SLP discovery, rsh/rcp, Cisco IOS<br>Telnet, and a RAM-only volatile workspace.
Scripting API
The package exposes the same curated API used by the embedded REPL:
import axross
local = axross.localfs()<br>for item in local.list_dir(".")[:5]:<br>print(item.name, item.size)
In the GUI, the bottom Console dock adds persistent history, docs,<br>slash commands, and bundled scripts such as mirror, dedupe,<br>find-secrets, port-scan, SLP inventory, Cisco IOS collection,<br>IMAP archive, checksum diff, and TFTP audit.
Runnable scripting examples ship with the package under<br>examples/scripting_api/. The local examples are tested without<br>network access, and the Docker-lab examples exercise protocol-backed<br>recipes against tests/docker/docker-compose.yml.
Multi-System Workflows
Recent releases add operational workflow verbs on top of the core<br>backends:
axross.where_was_i() recalls recently touched hosts and paths.
axross.health_pulse() reports live latency / stale-session state.
axross.compare_file() and axross.inspect_targets() compare files<br>across hosts and protocols.
axross.federated_search() fans one query out across many backends.
axross.resumable_copy() adds checkpoint-resume for...