Hussh (pronounced "hush") is a client-side ssh library that offers low level performance through a high level interface.
Hussh uses pyo3 to create Python bindings around the ssh2 and russh libraries for Rust; these allow for synchronous and asynchronous ssh connections.
pip install hussh
Hussh's synchronous Connection class will likely be your primary interface.
from hussh import Connection
conn = Connection(host="my.test.server", username="user", password="pass")
result = conn.execute("ls")
print(result.stdout)That's it! One import and class instantion is all you need to:
- Execute commands
- Perform SCP actions
- Perform SFTP actions
- Get an interactive shell
- 🔥 Blazingly fast!
- 🪶 Incredibly lightweight!
- 🧠 Super easy to use!
- ⚡ Asynchronous!
- 🥞 Concurrency!
Hussh demonstrates the performance you'd expect from a low level ssh library. Hussh is also much lighter weight in both total memory and memory allocations.
Local Server
Remote Server
Hussh's benchmark script are also open sourced in the benchmarks directory in this repository.
Clone the repo, follow the setup instructions, then let us know how it did!
from hussh import Connection
# Password authentication
conn = Connection(host="my.test.server", username="user", password="pass")
# Key-based authentication
conn = Connection(host="my.test.server", private_key="~/.ssh/id_rsa")result = conn.execute("whoami")
print(result.stdout, result.stderr, result.status)# Write a local file to remote
conn.sftp_write(local_path="/path/to/my/file", remote_path="/dest/path/file")
# Read a remote file
contents = conn.sftp_read(remote_path="/dest/path/file")📚 For complete documentation including SCP, file tailing, interactive shells, and more, see Synchronous Usage.
Hussh offers an AsyncConnection class for asynchronous operations.
import asyncio
from hussh.aio import AsyncConnection
async def main():
async with AsyncConnection(host="my.test.server", username="user", password="pass") as conn:
result = await conn.execute("ls")
print(result.stdout)
asyncio.run(main())📚 For complete documentation including timeouts, async SFTP, interactive shells, and file tailing, see Asynchronous Usage.
When you need to execute commands or transfer files across multiple hosts simultaneously, use MultiConnection.
from hussh.multi_conn import MultiConnection
# Create connections with shared authentication
mc = MultiConnection.from_shared_auth(
hosts=["server1", "server2", "server3"],
username="user",
password="pass",
)
# Execute on all hosts
with mc:
results = mc.execute("whoami")
for host, result in results.items():
print(f"{host}: {result.stdout.strip()}")📚 For complete documentation including MultiResult handling, SFTP operations, file tailing, error handling, and concurrency control, see MultiConnection Usage.
For detailed guides and complete API documentation, see the docs directory:
| Guide | Description |
|---|---|
| Synchronous Usage | Full Connection documentation: auth, SFTP, SCP, tailing, shells |
| Asynchronous Usage | Full AsyncConnection documentation: timeouts, async operations |
| MultiConnection Usage | Concurrent operations across multiple hosts |
This is an early project that should not be used in sensitive production code! With that said, try it out and let me know your thoughts!
- Low level bindings
- TBD...