aegis-stack 0.5.0

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

You need to ship reliable software, but management only gave you 2 weeks.

No time for health checks, proper testing, or clean architecture. Just enough time for duct tape and hope.

What if you could go from idea to working prototype in the time it takes to grab coffee?

Aegis Stack is a CLI that scaffolds modular Python applications — start with an API, add Auth, Scheduler, Workers, or AI services when you need them.

Prerequisites

• Python 3.11+
• Docker & Docker Compose - Required for the standard development workflow (make serve). Generated projects use Docker for consistent environments and service dependencies (Redis for workers, health monitoring, etc.).

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 serve

Installation alternatives: See the Installation Guide for uv tool install, pip install, and development setup.

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

# Stay current with template improvements
aegis update

Starter	Add Later?	Remove Later?	Git Conflicts?
Others	❌ Locked at init	❌ Manual deletion	⚠️ High risk
Aegis Stack	✅ One command	✅ One command	✅ Auto-handled

Most starters lock you in at init. Aegis Stack doesn't. See Evolving Your Stack for the complete guide.

See It In Action

Overseer - Built-In Health Monitoring

Overseer is the read-only health monitoring dashboard built into every Aegis Stack project. It provides real-time visibility into all your components (Backend, Database, Worker, Scheduler) and services (Auth, AI, Comms) through a web UI and CLI commands.

No Datadog. No New Relic. No vendor lock-in. Just centralized monitoring you own from day one.

CLI Health Monitoring

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

Available Components & Services

Components (infrastructure)

• Core - API + Frontend (always included)
• Database - ORM with health monitoring
• Scheduler - Background tasks, cron jobs
• Worker - Async task queues

Services (business logic)

• Auth - User authentication & JWT
• AI - Multi-provider AI chat
• Comms - Email, SMS, voice calls

Components Docs → | Services Docs →

Learn More

• CLI Reference - Complete command reference
• About - The philosophy and vision behind Aegis Stack
• Evolving Your Stack - Add/remove components as needs change
• Technology Stack - Battle-tested technology choices

For The Veterans

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 tool gets out of your way so you can get started.