Build production-ready Python applications with your chosen components and services.
Aegis Stack is a CLI-driven framework for creating custom Python applications. Select exactly the components you need - no bloat, no unused dependencies.
# Run instantly without installation
uvx aegis-stack init my-api
# Create with user authentication
uvx aegis-stack init user-app --services auth
# Create with background processing
uvx aegis-stack init task-processor --components scheduler,worker
# Start building
cd my-api && uv sync && cp .env.example .env && make serverNo installation needed - just run it:
uvx aegis-stack init my-projectThat's it. uvx downloads, installs, and runs Aegis Stack in one command.
Alternative methods: Installation Guide covers uv tool install and pip install for specific workflows.
Your choices aren't permanent. Start with what you need today, add components when requirements change, remove what you outgrow.
# Monday: Ship MVP
aegis init my-api
# Week 3: Add scheduled reports
aegis add scheduler --project-path ./my-api
# Month 2: Need async workers
aegis add worker --project-path ./my-api
# Month 6: Scheduler not needed
aegis remove scheduler --project-path ./my-api| Framework | Add Later? | Remove Later? | Git Conflicts? |
|---|---|---|---|
| Others | ❌ Locked at init | ❌ Manual deletion | |
| Aegis Stack | ✅ One command | ✅ One command | ✅ Auto-handled |
Most frameworks lock you in at init. Aegis Stack doesn't. See Evolving Your Stack for the complete guide.
| Component | Purpose | Status |
|---|---|---|
| Core (FastAPI + Flet) | Web API + Frontend | ✅ Always Included |
| Database | SQLite + SQLModel ORM | ✅ Available |
| Scheduler | Background tasks, cron jobs | ✅ Available |
| Worker | Async task queues (arq + Redis) | 🧪 Experimental |
| Cache | Redis caching and sessions | 🚧 Coming Soon |
| Service | Purpose | Status |
|---|---|---|
| Auth | User authentication & JWT | ✅ Available |
| AI | Multi-provider AI chat | 🧪 Experimental |
Real-time monitoring with component status, health percentages, and cross-platform deployment (web, desktop, mobile).
Rich terminal output showing detailed component status, health metrics, and system diagnostics.
- 📖 CLI Reference - Complete command reference
- 🏗️ Components - Deep dive into available components
- 🔧 Services - Business services (auth, AI)
- 🧠 Philosophy - Architecture and design principles
No magic. No reinventing the wheel. Just the tools you already know, pre-configured and ready to compose.
Aegis Stack respects your expertise. We maintain existing standards - FastAPI for APIs, SQLModel for databases, arq for workers. No custom abstractions or proprietary patterns to learn. Pick your components, get a production-ready foundation, and build your way.
The framework gets out of your way so you can get started.