Boltra

Django-like productivity for FastAPI projects.

Boltra is a FastAPI development kit for building modern backend systems faster. It generates direct FastAPI code and adds structure, CLI automation, apps, ORM, admin, auth, workers, and Rust-powered performance modules — without hiding FastAPI.

boltra --help
boltra --version
boltra new myapp
cd myapp && uv sync && boltra dev

# Coming in Phase 5+
boltra add orm

Status

Early development. See doc/plan/phase.md for the phased roadmap.

Stack

Requirements

• Python ≥ 3.12
• uv (package manager)
• Rust ≥ 1.85 (maturin compiles boltra._native on install)

Development

# Install Python (uv manages the venv automatically)
uv sync --group dev

# Rebuild the PyO3 extension after Rust changes
uv run maturin develop --uv

# Run quality checks
uv run ruff check .
uv run ruff format --check .
uv run mypy src
uv run pytest

# Verify Python fallback when native is disabled
BOLTRA_DISABLE_NATIVE=1 uv run pytest

# Install pre-commit hooks
uv run pre-commit install

Native extension

The Rust crate crates/boltra-core exposes boltra._native via PyO3. Python code uses boltra.native.is_available() and always has a fallback path.

import boltra

boltra.is_available()      # True when PyO3 extension is loaded
boltra.native_version()    # "0.4.0"

Disable native acceleration (for testing or unsupported platforms):

BOLTRA_DISABLE_NATIVE=1 uv run pytest

Repository layout

boltra/
├── src/boltra/              # Python package
│   ├── native.py            # Rust bridge + fallback
│   └── _native.pyi          # Type stubs for PyO3 module
├── crates/boltra-core/      # PyO3 extension (maturin)
├── tests/
├── benchmarks/
├── doc/
│   ├── user/                # end-user guides
│   ├── developer/           # contributor docs
│   └── plan/
├── pyproject.toml           # maturin build backend
├── Cargo.toml               # Rust workspace (release LTO enabled)
└── uv.lock

Documentation

• Project vision
• Contributing

License

MIT — see LICENSE.