Docs menu · Python SDK
pip install stratadb

That is the whole install. Wheels are prebuilt — there is no Rust toolchain to set up and nothing compiles on your machine.

Wheels and platforms

  • abi3 — one wheel per platform works across Python 3.9+, so upgrades don’t need a new download.
  • Platforms: manylinux and musllinux (x86_64, aarch64), macOS (arm64, x86_64), and Windows x86_64.
  • The version tracks the engine: stratadb.__version__ equals the engine version, so the SDK and the database format always match.

CPU and GPU inference

The base wheel runs cloud inference on CPU — chat, embeddings, and reranking through cloud providers work out of the box. For GPU-accelerated local models, install the companion extra:

pip install "stratadb[cuda]"     # GPU-accelerated local model execution

Cloud inference needs no extra — only a provider API key (see db.ai). Local model execution is the piece that benefits from the GPU build.

Type checking

The package ships py.typed and generated stubs, so type checkers (mypy, pyright) see the full typed surface — every namespace method, its parameters, and its return model. Editors get autocomplete and inline signatures with no extra setup.

Verifying

import stratadb

print(stratadb.__version__)              # the installed engine/SDK version
with stratadb.open(cache=True) as db:  # ephemeral, no files touched
    db.kv.put("k", "v")
    assert db.kv.get("k") == b"v"

If that runs, the native binding loaded and the engine is live in your process.

Next

agents: this page as markdown → /docs/python/installation.md