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

Choose the method that works best for your workflow:

Instant usage (recommended):

uvx aegis-stack init my-project

Install globally with uv:

uv tool install aegis-stack
aegis init my-project

Traditional pip:

pip install aegis-stack
aegis init my-project

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.