File size: 2,396 Bytes
bd8ec19 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c 8a87cbb 211fd4c | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 | ---
tags:
- ai-agents
- orchestration
- python
- cli
- local-ai
license: mit
---
# Aegis
Aegis is a modular Python framework for composing controlled agent workflows, registries, memory, tool execution, policies, and evaluation.
The project currently provides a runnable command-line interface that executes tasks through the built-in Aegis orchestration layer.
## Current capabilities
- Typed agent and tool registries
- Planner, task agent, and evaluator workflow
- Runtime orchestration layer
- User-facing `aegis run` CLI
- Human-readable and structured JSON output
- Agent and workflow selection
- Execution step limits
- Stable process exit codes
- Pydantic-based contracts
- Ruff, mypy, and pytest validation
- Deterministic evaluation of task results
## Installation
### Clone from Hugging Face
This repository is currently private. You must authenticate with Hugging Face before cloning it.
```bash
hf auth login
git clone https://huggingface.co/jayc1978/aegis
cd aegis
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
```
Verify the installation:
```bash
aegis run --help
aegis run "Run the default Aegis workflow"
```
## CLI usage
Run the default workflow:
```bash
aegis run "Review this repository"
```
Run a specific agent:
```bash
aegis run --agent default-task "Review this repository"
```
Return structured JSON:
```bash
aegis run --output json "Review this repository"
```
Limit execution steps:
```bash
aegis run --max-steps 10 "Review this repository"
```
## Development
Run the full validation suite:
```bash
pytest
ruff check .
mypy src
```
Current verified baseline:
- 56 tests passed
- Ruff passed
- mypy passed
## Current limitations
- Memory is currently in-process only.
- No Ollama or Hugging Face inference provider is connected yet.
- The default workflow is deterministic.
- Tool integrations and policy enforcement remain limited.
- No persistent database, API server, or web interface is included yet.
## Project direction
Aegis is intended to become an auditable, policy-controlled runtime for AI-agent automation.
Its purpose is to control:
- which tools an agent may use
- what data an agent may access
- when human approval is required
- how agent actions are evaluated
- how execution history is recorded
## License
This project is licensed under the MIT License. See `LICENSE` for details.
|