Opinionated Python project stack. π Batteries included.
Key Features β’ Quick Start β’ Configuration β’ Credits β’ About the Core Contributors
Project Version Python Version GitHub repo size GitHub Actions Workflow Status
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 | β | β |
make init name=my-project description="My project description"- initialize projectmake all- runsmain.pymake fmt- runsruff format+ JSON formattingmake banner- create a new banner that makes the README nice πmake test- runs all tests intests/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
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.