Inspired by the Neverwinter Nights toolset, Project Zero Dawn, and Dr. Wily.
Full-stack Python apps that know what they are.
Aegis Stack gives you a complete FastAPI app, wired and running: API, workers, scheduler, database, auth and AI, with plugins for anything else. Alongside it is the Twin, a model of that app taken from its code and its live state. Overseer shows it live and lets you operate it, Illiana explains it, and CI catches changes that break its rules, whether you wrote them or your agents did.
BuildAn app. Build from a blueprint or pick your pieces. Add or remove them later; your changes are merged, not overwritten. |
ShipA server. One command, or one button in Overseer, provisions a server in your own Hetzner or DigitalOcean account, adds HTTPS, and deploys. The server, the bill, and the data stay yours. |
SeeA control plane. A live map of your system, from the whole stack down to a single function, with errors, deploys, jobs, resources, and cost on the same map. See Overseer. The same data is in your app's CLI and, for your agents, over MCP. |
AskAn operator, if you want one. Talk to Illiana or type. She reads that map, answers with diagrams instead of guesses, and reviews every pull request against the system's rules. |
What you could build
Each is uvx aegis-stack init my-app with:
| Build | With |
|---|---|
| A SaaS MVP with billing | -s auth,payment -c database,htmx,worker |
| A finance app with an MCP server | -b finance -c database,scheduler,worker,mcp |
| A voice agent for your meetings | -s "meetings,ai[sqlite,voice]" |
| A document vault, read by AI | -s auth,documents,ai -c database,storage,worker |
| A local AI app on Ollama | -s "ai[ollama]" |
5 more
| Build | With |
|---|---|
| Email, SMS and calls from your app | -s comms -c worker |
| A Markdown blog with an editor | -s blog |
| A tracker for posts on your topic | -s research -c database,scheduler |
| Adoption analytics | -s "insights[github,pypi]" |
| Background jobs at scale | -c worker,scheduler |
Running on it
| Live | What it is |
|---|---|
| Aegis Pulse | Package analytics with honest decomposition (total, filtered, human) |
| Sector 7G | Millions of tasks on a single $5 VPS, zero restarts |
| NWVault Revival | A searchable archive of the original Neverwinter Vault (2002-2014), built in 24 hours |
Quick Start
uvx aegis-stack init my-app
init opens a full-screen guided setup that walks through every component and service with explanations. Prefer the classic one-line prompts? Pass --quick.
More examples
# Skip the guided setup, use the classic one-line prompts
uvx aegis-stack init my-app --quick
# Add user authentication out of the box
uvx aegis-stack init user-app --services auth
# Add background processing + scheduling
uvx aegis-stack init task-processor --components scheduler,worker
# Everything wired up at init
uvx aegis-stack init full-app --services auth,payment,comms --components worker,scheduler
CLI in 9 languages: English, German, Spanish, French, Japanese, Korean, Russian, Simplified Chinese, Traditional Chinese. Run e.g.
uvx aegis-stack --lang zh init my-app, or setAEGIS_LANG=zh.
Installation alternatives: See the Installation Guide for uv tool install, pip install, and development setup.
Customizing Your Stack
Components are infrastructure pieces (database, workers, scheduler, cache). Services are business capabilities (auth, AI, payments, comms).
Don't worry about what you pick today. Add anything later with a single command and remove what you outgrow. Where a change touches files you've edited, your edits are merged in, and anything that can't merge cleanly is marked for you to review.
# Monday: Ship MVP
aegis init my-app
# Week 3: Add scheduled reports
aegis add scheduler --project-path ./my-app
# Month 2: Need async workers
aegis add worker --project-path ./my-app
# Month 6: Scheduler not needed
aegis remove scheduler --project-path ./my-app
# Stay current with template improvements
aegis update
See Evolving Your Stack for the complete guide.
Components
| Component | What you get | |
|---|---|---|
| Backend | FastAPI on uvicorn or granian, lifecycle hooks, in-memory request metrics, API load testing for every route | |
| CLI | Typer, first-class system interface | |
| Frontend | Flet, ships with the Overseer system dashboard | |
| Browser | Remote Chromium in its own container, driven over Playwright: JavaScript pages, sign-ins, a bot that joins a meeting | |
| Database | Postgres (self-hosted or Neon serverless) or SQLite + SQLModel ORM | |
| Deploy | Deployment target (Docker Compose), read by the Overseer | |
| Inference | Local AI models via Ollama | |
| Ingress | Traefik v3 reverse proxy with TLS | |
| MCP | Serves the app's own tools to Claude Desktop, Claude Code or a local model over MCP: the tools you grant, never a write | |
| Observability | Pydantic Logfire tracing + metrics + logging | |
| Redis | Redis for caching, sessions, pub/sub | |
| Scheduler | APScheduler with persistent jobs | |
| Secrets | Encrypted credential store: keys set while the app runs, checked with the provider on paste, never shown again | |
| Storage | S3 object storage for the files an app keeps, SeaweedFS in dev | |
| Web Frontend | Server-rendered pages at /: Jinja2 + htmx + Alpine, Tailwind/DaisyUI styling |
|
| Worker | Pluggable Arq, Taskiq, or Dramatiq |
Services
| Service | What you get | |
|---|---|---|
| AI | Conversational agents, RAG, model catalog, TTS and STT (PydanticAI / LangChain across 7 providers) | |
| Auth | Persistent sessions with refresh-token rotation, GitHub/Google sign-in, RBAC, multi-tenant Organizations | |
| Blog | Markdown publishing with drafts, tags, and an Overseer editor | |
| Comms | Transactional email (Resend) + SMS / voice (Twilio) | |
| Documents | Content-addressed document store, deduped, with page-addressed extraction | |
| Finance | Personal finance aggregation (accounts, transactions, net worth, import) | |
| Insights | Adoption metrics across GitHub, PyPI, Plausible, Reddit | |
| Meetings | A bot that joins Google Meet as its own agent: transcript, notes, threads, people, what keeps coming up, joined from its calendar | |
| Payment | Stripe checkout, subscriptions, refunds, disputes | |
| Research | Outside posts and threads, collected by saved searches |
Plugins
What the built-in services don't cover can come from a plugin: a Python package that adds routes, tables, a CLI and a dashboard card, and goes in and out the same way (aegis add <name>, aegis remove <name>). Browse them at aegis-stack.io/plugins or with aegis plugins search, and start your own with aegis plugins create.
Deploy and back up
- Provision a server in your own Hetzner or DigitalOcean account, price shown first, with
aegis deploy-provisionor from Overseer > Deployments. HTTPS comes with it. - Deploy to any VPS over SSH with
aegis deploy: rsync and Docker, no PaaS lock-in. - Back up before every deploy, roll back on a failed health check, keep encrypted nightly copies off the server, and run a drill that proves they restore.
- CI on every push: GitHub Actions for lint, types and tests, CodeQL scanning, and an optional continuous-deploy workflow.
Integrations
Aegis Stack is the orchestration layer. Services and components wire into best-in-class tools you already trust, so you keep your vendor choices and your data.
For The Veterans
No reinventing the wheel. It's FastAPI, SQLModel, Pydantic and the rest of the tools you already know, wired together and ready to compose.
No custom abstractions or proprietary framework to learn. Once your stack is generated, it's your code: build it however you want. The Twin reads the code as it is; it doesn't ask you to write it a special way.
Aegis gets out of your way so you can get started.
Metadata
Release files for aegis-stack 0.19.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aegis_stack-0.19.1.tar.gz | 9.5 MB | With provenance | Details for aegis_stack-0.19.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aegis_stack-0.19.1-py3-none-any.whl | Python 3 | none | any | Details for aegis_stack-0.19.1-py3-none-any.whl |
Total release size: 20.5 MB
Release files / aegis_stack-0.19.1.tar.gz
| Download URL | aegis_stack-0.19.1.tar.gz |
|---|---|
| Size | 9.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fea94a1c9d67402d5492ae932f2ccb2f137f08f3b8beda0ab161182a6635c349
|
|
BLAKE2b-256 checksum How to use checksums |
de911e6c87dd250f74f745fdb747d2be7ef471c5b7562ebf8b18513503a889c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logRelease files / aegis_stack-0.19.1-py3-none-any.whl
| Download URL | aegis_stack-0.19.1-py3-none-any.whl |
|---|---|
| Size | 10.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f8035a91c7bab3f8f7b0b89b3647ea5fec8e0e434c9e58c98486c8505ba01068
|
|
BLAKE2b-256 checksum How to use checksums |
f4001372d677b22346a42382863b066926700fccc3d80e3f43dcb2001206e06c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logSecurity for aegis-stack 0.19.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for aegis_stack-0.19.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.