synth-ai 0.11.0

Python-only SDK for Synth containers, tunnels, and container pools

Synth AI

Python-only SDK and CLI for Synth's containers platform.

The stable surface is intentionally narrow:

• synth_ai.sdk.containers
• synth_ai.sdk.tunnels
• synth_ai.sdk.pools
• synth_ai.sdk.horizons_private
• synth_ai.sdk.managed_agents_anthropic
• synth_ai.client.SynthClient

Legacy optimization, inference, graphs, verifiers, managed-research, and Rust-backed modules have been archived under ../research/old/synth_ai and are no longer part of the supported import surface.

Stable API

from synth_ai import SynthClient

client = SynthClient(api_key="sk_...")
client.containers.list()
client.tunnels.list()
client.pools.list()
client.horizons_private.create_runtime({"name": "hp-runtime"})
client.managed_agents.health()

Canonical backend paths:

• /v1/containers/*
• /v1/tunnels/*
• /v1/pools/*
• /v1/rollouts/*
• /api/managed-agents/anthropic/v1/*

Product surfaces

Use this split to pick the right client quickly:

Surface	Client	Backend path family	Use when
Pools / Rhodes	client.pools and client.horizons_private	/v1/pools/*, /v1/rollouts/*	You need repeatable pool/task/rollout execution and rollout artifacts/usage.
Managed Agents (Anthropic view)	client.managed_agents	/api/managed-agents/anthropic/v1/*	You need live managed-agents session APIs through backend BFF proxy.

Local development

uv sync --group dev
uv run ruff format --check .
uv run ruff check .
# ty: use the same command as `.github/workflows/ci.yml` → job `type-check` (Lefthook runs it on staged files).
uv run ty check

Use uv run for Python tools (not bare python / python3). Ruff handles both formatting and linting for synth_ai/; ty type-checks synth_ai/ ([tool.ty.src] in pyproject.toml). A plain ty check may be stricter than CI; match CI when debugging PR failures.

Optional: install Lefthook and run lefthook install to run uv run ruff format, uv run ruff check, and uv run ty check on staged .py files (see lefthook.yml).