# Aegis Stack 🛡️
[](https://github.com/lbedner/aegis-stack/actions/workflows/ci.yml)
[](https://github.com/lbedner/aegis-stack/actions/workflows/docs.yml)
[](https://www.python.org/downloads/)
**Build production-ready Python applications with your chosen components.**
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
```bash
# Install
pip install aegis-stack
# Create a simple API
aegis init my-api
# Create with background processing
aegis init task-processor --components scheduler,worker
# Start building
cd my-project && uv sync && source .venv/bin/activate && make run-local
```
## 🧩 Available Components
| Component | Purpose | Status |
|-----------|---------|--------|
| **Core** (FastAPI + Flet) | Web API + Frontend | ✅ **Included** |
| **Scheduler** | Background tasks, cron jobs | ✅ **Available** |
| **Worker** | Async task queues, job processing | ✅ **Available** |
| **Database** | PostgreSQL + SQLAlchemy + Alembic | 🚧 **Coming Soon** |
| **Cache** | Redis caching and sessions | 🚧 **Coming Soon** |
## What You Get
- **FastAPI backend** with automatic API documentation
- **Flet frontend** with health dashboard
- **CLI management** with health monitoring commands
- **Worker queues** with async task processing and load testing
- **Production ready** with structured logging and containerization
- **Async-first** architecture for high-concurrency workloads
## 📱 System Health Dashboard
Real-time monitoring with component status, health percentages, and cross-platform deployment (web, desktop, mobile).
## 📚 Learn More
- **[📖 CLI Reference](docs/cli-reference.md)** - Complete command reference
- **[🏗️ Components](docs/components/index.md)** - Deep dive into available components
- **[🧠 Philosophy](docs/philosophy.md)** - Architecture and design principles
## Development Commands
```bash
make run-local # Start development server
make test # Run test suite
make check # Run all quality checks
make docs-serve # Serve documentation
```
Built on FastAPI, Flet, Typer, and other open-source tools.
Raw data
{
"_id": null,
"home_page": null,
"name": "aegis-stack",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "boilerplate, cli, cookiecutter, database, fastapi, generator, python, scaffold, scheduler, stack, template, worker",
"author": null,
"author_email": "Leonard Bedner <gamecoder99@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/1e/5e/1bcf54344b034191391b7454f1c661aa13283dd5af6234ddec0c6a5aa017/aegis_stack-0.1.0.tar.gz",
"platform": null,
"description": "# Aegis Stack \ud83d\udee1\ufe0f\n\n[](https://github.com/lbedner/aegis-stack/actions/workflows/ci.yml)\n[](https://github.com/lbedner/aegis-stack/actions/workflows/docs.yml)\n[](https://www.python.org/downloads/)\n\n**Build production-ready Python applications with your chosen components.**\n\nAegis Stack is a CLI-driven framework for creating custom Python applications. Select exactly the components you need - no bloat, no unused dependencies.\n\n## \ud83d\ude80 Quick Start\n\n```bash\n# Install\npip install aegis-stack\n\n# Create a simple API\naegis init my-api\n\n# Create with background processing \naegis init task-processor --components scheduler,worker\n\n# Start building\ncd my-project && uv sync && source .venv/bin/activate && make run-local\n```\n\n## \ud83e\udde9 Available Components\n\n| Component | Purpose | Status |\n|-----------|---------|--------|\n| **Core** (FastAPI + Flet) | Web API + Frontend | \u2705 **Included** |\n| **Scheduler** | Background tasks, cron jobs | \u2705 **Available** |\n| **Worker** | Async task queues, job processing | \u2705 **Available** |\n| **Database** | PostgreSQL + SQLAlchemy + Alembic | \ud83d\udea7 **Coming Soon** |\n| **Cache** | Redis caching and sessions | \ud83d\udea7 **Coming Soon** |\n\n## What You Get\n\n- **FastAPI backend** with automatic API documentation\n- **Flet frontend** with health dashboard \n- **CLI management** with health monitoring commands\n- **Worker queues** with async task processing and load testing\n- **Production ready** with structured logging and containerization\n- **Async-first** architecture for high-concurrency workloads\n\n## \ud83d\udcf1 System Health Dashboard\n\n\n\n\nReal-time monitoring with component status, health percentages, and cross-platform deployment (web, desktop, mobile).\n\n## \ud83d\udcda Learn More\n\n- **[\ud83d\udcd6 CLI Reference](docs/cli-reference.md)** - Complete command reference\n- **[\ud83c\udfd7\ufe0f Components](docs/components/index.md)** - Deep dive into available components \n- **[\ud83e\udde0 Philosophy](docs/philosophy.md)** - Architecture and design principles\n\n## Development Commands\n\n```bash\nmake run-local # Start development server\nmake test # Run test suite \nmake check # Run all quality checks\nmake docs-serve # Serve documentation\n```\n\nBuilt on FastAPI, Flet, Typer, and other open-source tools.",
"bugtrack_url": null,
"license": "MIT",
"summary": "A production-ready Python foundation for builders who refuse to wait",
"version": "0.1.0",
"project_urls": {
"Changelog": "https://github.com/lbedner/aegis-stack/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/lbedner/aegis-stack#readme",
"Homepage": "https://github.com/lbedner/aegis-stack",
"Issues": "https://github.com/lbedner/aegis-stack/issues",
"Repository": "https://github.com/lbedner/aegis-stack"
},
"split_keywords": [
"boilerplate",
" cli",
" cookiecutter",
" database",
" fastapi",
" generator",
" python",
" scaffold",
" scheduler",
" stack",
" template",
" worker"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ab84d2c4a29084d856838e32af7f336cd553d2917f907a6a15c4b7e813e38943",
"md5": "5b42f9143b4f21c8e2d9b6aba38ad71e",
"sha256": "a8f08a13ec0a1611bc4377169f6dbb12e7c24f404562d4e2c89c0bd88c92b831"
},
"downloads": -1,
"filename": "aegis_stack-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5b42f9143b4f21c8e2d9b6aba38ad71e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 228824,
"upload_time": "2025-08-29T01:17:31",
"upload_time_iso_8601": "2025-08-29T01:17:31.246587Z",
"url": "https://files.pythonhosted.org/packages/ab/84/d2c4a29084d856838e32af7f336cd553d2917f907a6a15c4b7e813e38943/aegis_stack-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1e5e1bcf54344b034191391b7454f1c661aa13283dd5af6234ddec0c6a5aa017",
"md5": "06d0ce513912df4f6c46869598dbdaa4",
"sha256": "e0350c8ff4176796cd3da3803ef60006aa9437a06fa5e5260f252f8bdd037acd"
},
"downloads": -1,
"filename": "aegis_stack-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "06d0ce513912df4f6c46869598dbdaa4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 206906,
"upload_time": "2025-08-29T01:17:32",
"upload_time_iso_8601": "2025-08-29T01:17:32.872474Z",
"url": "https://files.pythonhosted.org/packages/1e/5e/1bcf54344b034191391b7454f1c661aa13283dd5af6234ddec0c6a5aa017/aegis_stack-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-29 01:17:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lbedner",
"github_project": "aegis-stack",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "aegis-stack"
}
JSON
