A Python SDK and CLI for Synth hosted infrastructure, providing programmatic management of containers, tunnels, and pools, with support for managed AI research workflows.
Synth AI (package name synth-ai, current version 0.10.0) is the official Python SDK for the Synth platform, exposing three core infrastructure management modules through the unified SynthClient entry point: containers (managed container records and metadata), tunnels (managed tunnel records and lease management), and pools (container pools, tasks, rollouts, artifacts, usage, and events). The underlying implementation is Rust-based (89.5% of the repository), with Python as the upper-layer wrapper. Requires Python >= 3.11, licensed under MIT.
The platform also offers Managed Research: users submit code repositories and research goals to Synth-hosted AI workers, which handle workspace orchestration and persist outputs (messages, tasks, logs, checkpoints, artifacts, usage, PRs, final reports). It supports an MCP-first interface (launchable from Codex, Claude Code, Cursor, etc.) and Python SDK scripted workflows. Typical use cases include Eval Harness Improvement, Benchmark Improvement, Repo Review and PR, and Checkpoint Branching.
Authentication is via the SYNTH_API_KEY environment variable or constructor parameter, defaulting to the https://api.usesynth.ai backend with overridable base_url. Installation also registers the synth-ai CLI entry point. The optional synth-ai[providers] extra integrates anthropic, groq, and google-genai LLM providers. Early-stage modules (prompt optimization, inference, graphs, verifiers) have been archived and are no longer part of the supported SDK surface.
Installation & Quick Start
uv add synth-ai
export SYNTH_API_KEY="sk_..."
from synth_ai import SynthClient
client = SynthClient()
print(client.containers.list())
print(client.tunnels.list())
print(client.pools.list())
Authentication Model
| Key Type | Purpose | Configuration |
|---|---|---|
| Synth API Key | Backend auth (SDK calls) | SYNTH_API_KEY env var or SynthClient(api_key=...) |
| Environment API Key | Container auth (backend/tunnel to local container) | ENVIRONMENT_API_KEY env var |
| SynthTunnel Worker Token | Tunnel relay auth | tunnel.worker_token config |
Unconfirmed Information
- Platform pricing and free tier not confirmed from public materials
- Managed Research public availability status (GA/Beta/restricted) not explicitly stated
- Whether
synth_ai_rs(Rust bindings) serves as Python binding layer or backend service code not fully confirmed - Whether early Prompt Optimization capability is indirectly provided via Managed Research not confirmed
- CLI subcommand list not covered