Metadata-Version: 2.4
Name: animus-forge
Version: 1.3.0
Summary: Multi-agent orchestration framework for production AI workflows
Author-email: AreteDriver <aretedriver@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/AreteDriver/animus
Project-URL: Repository, https://github.com/AreteDriver/animus
Keywords: multi-agent,ai,orchestration,workflow
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: openai<3,>=2.15.0
Requires-Dist: anthropic<1,>=0.79.0
Requires-Dist: fastapi<1,>=0.128.0
Requires-Dist: uvicorn<1,>=0.40.0
Requires-Dist: streamlit<2,>=1.53.0
Requires-Dist: google-auth<3,>=2.35.0
Requires-Dist: google-auth-oauthlib<2,>=1.2.0
Requires-Dist: google-auth-httplib2<1,>=0.3.0
Requires-Dist: google-api-python-client<3,>=2.150.0
Requires-Dist: notion-client<4,>=3.0.0
Requires-Dist: PyGithub<3,>=2.4.0
Requires-Dist: pydantic<3,>=2.12.0
Requires-Dist: pydantic-settings<3,>=2.13.0
Requires-Dist: python-dotenv<2,>=1.0.0
Requires-Dist: aiofiles<26,>=25.1.0
Requires-Dist: apscheduler<4,>=3.11.0
Requires-Dist: urllib3<3,>=2.6.0
Requires-Dist: pynacl<2,>=1.6.0
Requires-Dist: pyasn1<1,>=0.6.1
Requires-Dist: typer<1,>=0.23.0
Requires-Dist: rich<15,>=14.0.0
Requires-Dist: pyyaml<7,>=6.0.0
Requires-Dist: jsonschema<5,>=4.23.0
Requires-Dist: slowapi<1,>=0.1.9
Requires-Dist: bcrypt<6,>=5.0.0
Requires-Dist: cryptography<47,>=46.0.5
Requires-Dist: textual<9,>=8.0.0
Requires-Dist: convergentai<2,>=1.1.0
Provides-Extra: postgres
Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgres"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Provides-Extra: messaging
Requires-Dist: python-telegram-bot>=22.0; extra == "messaging"
Requires-Dist: discord-py>=2.3.0; extra == "messaging"
Provides-Extra: browser
Requires-Dist: playwright>=1.40.0; extra == "browser"
Provides-Extra: local
Requires-Dist: httpx>=0.28.0; extra == "local"
Requires-Dist: psutil>=7.0.0; extra == "local"
Provides-Extra: all
Requires-Dist: animus-forge[browser,local,mcp,messaging,postgres]; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=9.0.2; extra == "dev"
Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=1.3.0; extra == "dev"
Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
Requires-Dist: ruff>=0.15.1; extra == "dev"

# Animus Forge

Multi-agent orchestration framework for production AI workflows.

## Features

- **Workflow executor** — YAML-defined multi-agent pipelines with mixins (AI, MCP, queue, graph)
- **Provider abstraction** — Anthropic, OpenAI, Ollama, and more
- **Self-improvement** — Analyze codebase, generate improvements, test in sandbox, create PRs
- **Budget management** — Persistent token/cost tracking per workflow
- **Eval framework** — Benchmark and score agent outputs
- **MCP tool execution** — Bridge to Model Context Protocol servers
- **CLI + API + TUI** — Multiple interfaces for workflow management

## Install

```bash
pip install animus-forge
```

## Quick Start

```bash
# Run a workflow
gorgon run workflows/examples/build_task.yaml

# Self-improve a codebase
gorgon self-improve run --provider ollama --path /my/project

# Analyze without making changes
gorgon self-improve analyze --focus security
```

## Self-Improvement Pipeline

The self-improve orchestrator runs a 10-stage workflow:

1. **Analyze** — Static analysis identifies improvement opportunities
2. **Plan** — AI generates an improvement plan from suggestions
3. **Safety check** — Validates against protected files and change limits
4. **Snapshot** — Creates rollback point before any changes
5. **Implement** — AI generates code changes
6. **Sandbox test** — Applies changes to temp copy, runs tests and lint
7. **Apply** — Writes changes to the actual codebase
8. **Create PR** — Creates a branch and pull request
9. **Human approval** — Waits for merge approval (skippable with `--auto-approve`)
10. **Rollback** — Automatic rollback if tests fail at any stage

## Part of the Animus Monorepo

- [Animus Core](https://pypi.org/project/animus-core/) — exocortex engine
- [Animus Quorum](https://pypi.org/project/convergentAI/) — coordination protocol
- [Animus Bootstrap](https://github.com/AreteDriver/animus/tree/main/packages/bootstrap) — system daemon

## License

MIT
