Metadata-Version: 2.4
Name: aegis-stack
Version: 0.1.0
Summary: A production-ready Python foundation for builders who refuse to wait
Project-URL: Homepage, https://github.com/lbedner/aegis-stack
Project-URL: Documentation, https://github.com/lbedner/aegis-stack#readme
Project-URL: Repository, https://github.com/lbedner/aegis-stack
Project-URL: Issues, https://github.com/lbedner/aegis-stack/issues
Project-URL: Changelog, https://github.com/lbedner/aegis-stack/blob/main/CHANGELOG.md
Author-email: Leonard Bedner <gamecoder99@gmail.com>
License: MIT
Keywords: boilerplate,cli,cookiecutter,database,fastapi,generator,python,scaffold,scheduler,stack,template,worker
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: cookiecutter>=2.6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: mypy>=1.8.0; extra == 'dev'
Requires-Dist: pip-audit>=2.6.0; extra == 'dev'
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-gen-files>=0.5.0; extra == 'docs'
Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
Requires-Dist: mkdocs-mermaid2-plugin>=1.1.0; extra == 'docs'
Requires-Dist: mkdocs>=1.5.0; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
Requires-Dist: pymdown-extensions>=10.0.0; extra == 'docs'
Description-Content-Type: text/markdown

# Aegis Stack 🛡️

[![CI](https://github.com/lbedner/aegis-stack/workflows/CI/badge.svg)](https://github.com/lbedner/aegis-stack/actions/workflows/ci.yml)
[![Documentation](https://github.com/lbedner/aegis-stack/workflows/Deploy%20Documentation/badge.svg)](https://github.com/lbedner/aegis-stack/actions/workflows/docs.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](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

![System Health Dashboard](docs/images/dashboard-light.png#only-light)
![System Health Dashboard](docs/images/dashboard-dark.png#only-dark)

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.