Opinionated Python project stack. 🔋 Batteries included.

Key Features • Quick Start • Configuration • Credits • About the Core Contributors

Opinionated Python stack for fast development. The saas branch extends main with web framework, auth, and payments.

Full comparison

• make init name=my-project description="My project description" - initialize project
• make all - runs main.py
• make fmt - runs ruff format + JSON formatting
• make banner - create a new banner that makes the README nice 😊
• make test - runs all tests in tests/
• make ci - runs all CI checks (ruff, vulture, ty, etc.)

from common import global_config

# Access config values from common/global_config.yaml
global_config.example_parent.example_child

# Access secrets from .env
global_config.OPENAI_API_KEY

Full configuration docs

This software uses the following tools:

• Cursor: The AI Code Editor
• uv
• prek: Rust-based pre-commit framework
• DSPY: Pytorch for LLM Inference
• LangFuse: LLM Observability Tool

Made with contrib.rocks.