autogen

Part of the Coding-Autopilot-System ecosystem: gsd-orchestrator | Promptimprover

autogen is a Python multi-agent orchestration runtime built on Microsoft Agent Framework — combining a Gemini/Claude provider fallback chain, AG-UI observability, and a local operator workbench for end-to-end autonomous engineering workflows.

Features

• Provider fallback chain — Gemini API (primary) -> Anthropic API -> local CLI fallback; routing policy classifies prompt complexity and selects provider automatically
• Multi-agent team orchestration — sequential planner->researcher->implementer->reviewer chain with FileCheckpointStorage for resumable runs
• Bounded repo tools — read/list/search/write with enforced scope limits; agents cannot access paths outside the configured repo root
• AG-UI observability — DevUI-discoverable workflows expose run state, specialist handoffs, and pause/approval events
• Human-in-the-loop approvals — approval policy gates destructive writes; operators review before execution proceeds

Architecture

flowchart LR
    Op["Operator\n(DevUI / Workbench)"] -->|"prompt"| MAF["autogen\n(MAF Runtime)"]
    MAF --> Gemini["Gemini API\n(primary)"]
    MAF --> Anthropic["Anthropic API\n(fallback)"]
    MAF --> CLI["Local CLIs\n(gemini-cli / claude)"]
    MAF --> Entities["Entities\n(repo_team, copilots)"]
    MAF --> Tools["Repo Tools\n(read / write / search)"]
    MAF --> Checkpoints["Checkpoints\n(FileCheckpointStorage)"]
    Entities --> Out["Run Output\n+ Artifacts"]
    Tools --> Out
    Checkpoints --> Out

Loading

Quickstart

git clone https://github.com/Coding-Autopilot-System/autogen.git
cd autogen
python -m venv .venv
# Windows: .\.venv\Scripts\Activate.ps1
# macOS/Linux: source .venv/bin/activate
pip install agent-framework python-dotenv

Copy .env.example to .env and set GEMINI_API_KEY. See the Setup Guide for full configuration instructions.

Configuration

Variable	Required	Default	Description
GEMINI_API_KEY	Yes	--	Gemini API key for primary model
MAF_MODEL	No	gemini-2.5-flash	Primary model for agent runs
MAF_FALLBACK_CHAIN	No	Auto	Comma-separated provider fallback order
ANTHROPIC_API_KEY	No	--	Anthropic API key for Claude fallback

See the Configuration Reference for the full variable list.

License

MIT -- see LICENSE