cmdop

PyPI

Python SDK

Turn any machine into an API endpoint. No SSH. No VPN. No open ports.

Quick Start

Install the SDK and start controlling remote machines in minutes.

Installation

Python 3.10+

pip install cmdop

quickstart.py

Python

from cmdop import CMDOPClient

# Remote server via cloud relay
with CMDOPClient.remote(api_key="cmd_xxx") as server:
    # Execute shell commands
    server.terminal.execute("docker restart app")

    # Manage files
    server.files.write("/etc/nginx/sites/new.conf", config)
    logs = server.files.read("/var/log/app/error.log")

Loading code...

Features

Everything you need to control remote machines programmatically.

Terminal Control

Full shell access with session management, signal handling, and output streaming.

File Management

Complete filesystem control: read, write, delete, copy, move files remotely.

AI Agents

Run LLM agents with Pydantic schema for type-safe structured responses.

Async Support

Full async/await support for high-performance concurrent operations.

Code Examples

Real-world examples to get you started quickly.

Terminal Sessions

terminal.py

Python

# Full terminal session control
session = server.terminal.create(shell="/bin/bash")
server.terminal.send_input(session.session_id, "kubectl get pods\n")
output = server.terminal.get_history(session.session_id)

# Send signals
server.terminal.send_signal(session.session_id, "SIGINT")

Loading code...

File Operations

files.py

Python

# Complete filesystem control
server.files.list("/home/user")
server.files.read("/etc/nginx/nginx.conf")
server.files.write("/tmp/config.json", b'{"key": "value"}')
server.files.delete("/tmp/garbage", recursive=True)
server.files.copy("/backup/db.sql", "/restore/db.sql")

Loading code...

AI Agents with Pydantic

agent.py

Python

from pydantic import BaseModel

class ServerHealth(BaseModel):
    status: str
    cpu_percent: float
    memory_used_gb: float
    disk_free_gb: float
    issues: list[str]

# Run agent, get typed response
result = server.agent.run(
    prompt="Check server health and report issues",
    output_schema=ServerHealth
)
health: ServerHealth = result.output  # Fully typed!

Loading code...

Async Support

async_example.py

Python

from cmdop import AsyncCMDOPClient

async with AsyncCMDOPClient.remote(api_key="cmd_xxx") as client:
    await client.terminal.execute("echo hello")
    content = await client.files.read("/etc/hostname")

Loading code...

Ready to get started?

Install the Python SDK and start automating your infrastructure in minutes.

View on PyPI Documentation