README.md

Python-Template

Opinionated Python project stack. 🔋 Batteries included.

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

---

Key Features

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

Feature	main	saas
UV + Pydantic config	✅	✅
CI/Linters (Ruff, Vulture)	✅	✅
Pre-commit hooks (prek)	✅	✅
LLM (DSPY + LangFuse Observability)	✅	✅
FastAPI + Uvicorn	❌	✅
SQLAlchemy + Alembic	❌	✅
Auth (WorkOS + API keys)	❌	✅
Payments (Stripe)	❌	✅
Referrals + Agent system	❌	✅
Ralph Wiggum Agent Loop	✅	✅

Full comparison

Quick Start

• make onboard - interactive onboarding CLI (rename, deps, env, hooks, media)
• make all - sync deps and run main.py
• make fmt - runs ruff format + JSON formatting
• make test - runs all tests in tests/
• make ci - runs all CI checks (ruff, vulture, ty, etc.)

Configuration

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

Credits

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

About the Core Contributors

Made with contrib.rocks.