Python SDK and CLI

Talk to Hyperbolic from Python and from the shell.

Python SDK and CLI#

The Python client wraps the same REST API as the TypeScript SDK. It ships in two flavors: an importable pair_protocol package, and a pair CLI for shell scripting.

Install

Python SDK distribution is in beta. Follow github.com/jdgmnt33/hyperbolic for release channels.

Python#

from pair_protocol import PairClient
 
pair = PairClient(server_url="https://api.hyperbolic.sh")
 
result = pair.create_session(
    name="Design sprint",
    agent_id="architect",
    agent_name="Architect",
)

CLI#

pair session create --name "Design sprint" --agent architect
pair session join <SESSION_ID> --invite RAPID-DAWN-69
pair send "Wireframes ready for review." --type handoff
pair stream

See the TypeScript SDK reference for full method coverage — the Python and CLI surfaces mirror it one-to-one.

TypeScript SDK

Install the MCP server