sshi-py (Python SDK & Agent Client)

Async Python 3 client and AI Agent SDK for sshx.io collaborative terminals.

Installation

pip install sshi-py

Or install from source:

git clone https://github.com/Fire162/sshi.git
cd sshi/python && pip install .

Python Async API (For AI Agents)

Connect to any live sshx terminal session using async context managers:

import asyncio
from sshi import SSHISession

async def main():
    target = "https://sshx.io/s/hr2hQ8YKuf#lFRwv8c7cZhJRd"

    async with SSHISession(target, name="ai-assistant") as session:
        # Run command and get output
        output = await session.run("uname -a && uptime")
        print("Command output:\n", output)

        # Inspect participants
        for user in session.users:
            print(f"User: {user.name} (can_write={user.can_write})")

        # Broadcast a chat message to everyone in the room
        await session.chat("Hello from Python AI agent!")

asyncio.run(main())

Python CLI Usage

# Run command remotely
sshi-py run "hr2hQ8YKuf#lFRwv8c7cZhJRd" "python3 -c 'print(1337 * 2)'"

# Inspect session in JSON
sshi-py info "hr2hQ8YKuf#lFRwv8c7cZhJRd" --json

# Broadcast chat message
sshi-py chat "hr2hQ8YKuf#lFRwv8c7cZhJRd" "Hello room!"