Install

One package, no service:

pip install "ratel-ai==0.4.0"

The docs pin the version they document; drop the pin to track the latest release. The base SDK needs Python 3.10 or newer for the examples in these guides and has no runtime dependencies.

Prebuilt wheels

The SDK bundles Ratel's Rust core as a native module. Prebuilt abi3 wheels ship for:

• macOS: darwin-arm64, darwin-x64
• Linux (glibc): linux-x64-gnu, linux-arm64-gnu
• Windows: win32-x64-msvc

On these targets nothing compiles at install time and no Rust toolchain is needed.

Extras

• mcp — pip install 'ratel-ai[mcp]' pulls the official MCP client for register_mcp_server. Lazily imported: the base SDK installs and runs without it.
• otlp — pip install 'ratel-ai[otlp]' pulls the ratel.* span vocabulary and the OTLP exporter behind configure_telemetry(). See Telemetry & OTel.
• Semantic & hybrid retrieval — not an extra. Opting in downloads the local embedding model on first use; see Build the embedding cache and Semantic & hybrid search.

Next steps