Aegis Stack
Components Services Evolve Docs Star on GitHub · 122
Ship FastAPI apps that grow with you

Production FastAPI in one command. Evolve it without the rewrite.

Aegis Stack scaffolds complete FastAPI applications with auth, payments, workers, AI, and a built-in control plane. Add what you need, remove what you don't, update when the framework improves.

uvx aegis-stack init my-api && cd my-api && make serve

v0.7.0 · Python 3.11+ · open source · CLI in 9 languages

Watch it spin up

One command stands up the whole runtime.

This is a live build of Aegis Pulse, a production system scaffolded with Aegis Stack. Every component and service boots, links, and locks in dependency order.

Drag to spin · click any module to look inside

Components

Infrastructure, pre-wired.

Components are the infrastructure pieces of your stack: server, database, workers, cache. Each one arrives configured, tested, and already connected to the rest. Backend, CLI, and Frontend are always on; the rest are yours to pick.

Services

Business capabilities, one flag away.

Services are the product layer: sign-in, billing, messaging, AI. Each one ships as working code in your repository, wired to providers you already trust. All optional.

Evolve your stack

Your choices aren't permanent.

Start with what you need today. Add a component when requirements change, remove what you outgrow, and pull in template improvements with one command. Each change lands as a diff you review and commit, not a manual rewrite.

$ aegis init my-api
Monday: ship the MVP
$ aegis add scheduler
Week 3: scheduled reports
$ aegis add worker
Month 2: async workers
$ aegis remove scheduler
Month 6: not needed anymore
$ aegis update
Anytime: pull in template improvements

Most starters lock you in at init. Aegis Stack doesn't. Evolving your stack →

Aegis Stack
Evolving the runtime

One command in. One command out. Migrations and wiring handled.

Built-in control plane

A control plane you didn't have to build.

Every Aegis Stack project ships with Overseer: a live view of every component and service you picked, already wired. Health, worker queues, scheduled jobs, database state, AI usage, and sessions in one place. No external tooling, no vendor integrations, no setup.

Health Worker queues Scheduled jobs Database state AI usage Sessions
overseer · /dashboard
Overseer dashboard, shown running Aegis Pulse
Overseer, shown running Aegis Pulse.
Beyond the scaffold

CI, code scanning, and one-command deploys.

Every generated project ships with GitHub Actions and developer tooling pre-wired. The first push runs checks automatically, and one command wires continuous deployment to your own server.

CI workflow
Lint, type checking, and tests on every push and PR. Parallel jobs, cached.
Code scanning
CodeQL static analysis on every PR and on a weekly schedule.
Continuous deploy
Generates a deploy key, installs it on your server, pushes secrets to GitHub, and scaffolds the workflow.
Deploy CLI
One-command deploys to any VPS over SSH. rsync plus Docker, no PaaS lock-in.
Server setup
aegis deploy-setup provisions Ubuntu, Debian, or Fedora boxes with Docker and a firewall.
Backups and rollback
pg_dump before every deploy, a retention policy, and automatic rollback on failed health checks.
Beyond the dashboard

Two more ways to see your system.

The same live telemetry as Overseer, terminal-native and conversational.

Terminal-native

The CLI

  • Component-aware commands for every running subsystem
  • Inspect worker queues, scheduler runs, database state
  • Query AI usage, auth sessions, service configuration
  • The same data Overseer sees, built into every project
CLI reference →
aegis
The Aegis CLI inspecting a running system

Click to zoom

Click to zoom

Optional system operator

Illiana

  • Ask in plain language about live system state
  • Backed by the same telemetry as Overseer and the CLI
  • Optional RAG over your codebase for code-aware answers
  • Opt-in with the AI service. Nothing depends on her being there
AI service docs →
Integrations

The orchestration layer over tools you already trust.

Services and components wire into best-in-class providers, so you keep your vendor choices and your data.

Powered by Aegis Stack

Built with it, running in production.

Pick your components. Build your way.

No custom abstractions, no proprietary patterns to learn. The tools you already know, pre-configured and ready to compose. Aegis gets out of your way so you can get started.

uvx aegis-stack init my-api