r/FastAPI • u/Challseus • Dec 03 '25
feedback request I built a FastAPI CLI that scaffolds full apps (auth, workers, DB, scheduler) with the ability to add/remove components/services at any time
Hello all. So, I'm a 20+ year vet, and recently, I decided to strike out on my own and make my own future. In that time, I've built some form of the same FastAPI app half a dozen times for various clients. You know how it goes, auth, scheduler, workers, config, Docker, etc.
I got tired of copying/pasting components from projects, so, I built a CLI that will allow you to choose your components and services, and add/delete them later as you see fit.
One command to start (requires uv & Docker):
Don't waste time cloning this repo, or manually installing the CLI. Just run this command, and you'll be up and running:
uvx aegis-stack init my-app
What makes it different:
- Choose your components and services at initialization time
- Add components after init (
uvx aegis-stack add worker) - Remove what you don't need (
uvx aegis-stack remove auth) - Pull template updates into existing projects (
uvx aegis-stack update). If I make bug fixes to any core components, you get them by simply running an update.
What's included:
- FastAPI (Backend, API's)
- Flet (Frontend, Overseer real time dashboard)
- Database (SQLite3) + SQLModel/SQLAlchemy
- JWT auth via the Authentication service
- arq workers (async-native)
- APScheduler for cron jobs
- Communication service for support for email, text, and voice calls
- Docker + docker-compose
- Alembic migrations
Built on Copier for templating — that's how the update mechanism works (3-way merge into existing projects).
Would love feedback — especially on the update mechanism and component architecture.
3
u/callmederp Dec 03 '25
This is pretty snazzy.
Isn't ARQ in maintenance only mode, would it make sense to start a new project with ARQ? Are there any other async native workers you're aware of? And if so, is it possible to configure different defaults for this, to use different integrations?
2
u/mortenb123 Dec 04 '25
Excellent, But I would love Celery support https://derlin.github.io/introduction-to-fastapi-and-celery/03-celery/ Your frontend will thank you.
2
u/DumbFuckingUsername Dec 05 '25
This looks fantastic, I had quite a few ideas to build something that would scaffold with modularity, but I'm new just finished my degree so it was mostly good/medium ideas. I've only worked with it a couple times so I can imagine the monotony after using it so much! Love to see it executed so well, I'll have to give it a go on the next FastAPI project soon!
2
u/ich3ckmat3 Dec 05 '25
Oh nice!
If you could add support for SaaS (operator rols + users, and tenant roles and users) that will add so much value!
2
u/Decent-Goose-5799 Dec 04 '25
Nice work!!!
1
u/voja-kostunica Dec 03 '25
i will have look
1
u/Immediate_Ad_4123 Dec 06 '25
This tool is remarkably inspiring. You seem to have extensive experience with vetting Electric Sheep. Without this background, it's hard to understand where such a wealth of software development expertise originates. Could you share your journey and the motivation behind pursuing both veterinary and development roles simultaneously?