aegis-stack 0.2.1

A production-ready Python foundation for builders who refuse to wait. Try: uvx aegis-stack init my-project

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.

Quick Start

# 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 server

Installation

No installation needed - just run it:

uvx aegis-stack init my-project

That'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 Stack Grows With You

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	⚠️ High risk
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.

Available Components & Services

Infrastructure Components

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

Business Services

Service	Purpose	Status
Auth	User authentication & JWT	✅ Available
AI	Multi-provider AI chat	🧪 Experimental

See It In Action

System Health Dashboard

Real-time monitoring with component status, health percentages, and cross-platform deployment (web, desktop, mobile).

CLI Health Monitoring

Rich terminal output showing detailed component status, health metrics, and system diagnostics.

Learn More

• 📖 CLI Reference - Complete command reference
• 🏗️ Components - Deep dive into available components
• 🔧 Services - Business services (auth, AI)
• 🧠 Philosophy - Architecture and design principles

For The Veterans

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.