Python SDK
Install
Install ratel-ai: requirements, prebuilt wheels, the mcp and otlp extras, and the embedding model download.
One package, no service:
pip install ratel-aiThe 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 forregister_mcp_server. Lazily imported: the base SDK installs and runs without it.otlp:pip install 'ratel-ai[otlp]'pulls theratel.*span vocabulary and the OTLP exporter behindconfigure_telemetry(). See Telemetry & OTel.- Semantic & hybrid retrieval: not an extra. Opting in downloads the default local embedding model on first use; see The embedding cache and Semantic & hybrid search.