Getting Started
Installation
Install CentauroDB and its optional dependencies.
Basic install
pip install centaurodb
This installs CentauroDB with its only runtime dependency: Pydantic v2+. SQLite is included in Python's standard library — no extra setup needed.
CentauroDB is in beta (v0.9.x) — the SQLite path is ready for real workloads, while PostgreSQL connection pooling is still in the works. Pre-1.0, breaking changes are documented in the changelog.
Optional dependencies
Polars (time-series DataFrames)
If you want to use the .df property on time-series models to get Polars DataFrames:
pip install "centaurodb[polars]"
PostgreSQL
If you want to use PostgreSQL as your backend instead of SQLite:
pip install "centaurodb[postgres]"
This installs psycopg (the modern PostgreSQL adapter for Python).
For connection setup, URL formats, and a comparison with SQLite, see the PostgreSQL guide.
Verify the installation
import centaurodb
from centaurodb import Engine, Collection, CentauroModel
engine = Engine() # in-memory SQLite
print("CentauroDB is ready!")