semvec/pypi-packages huggingface dataset:
autopoe 0.2.3
A structured multi-agent framework for coordinated AI collaboration
Requires Python: >=3.12

# Autopoe

A multi-agent collaboration framework where lightweight AI agents work together through structured coordination to accomplish complex software development tasks.

## Installation

Pick one:

```bash
uvx autopoe                       # run without installing
uv tool install autopoe           # install via uv
pip install autopoe               # install via pip
```

To run from source, see [Development](#development).

## Prerequisites

- **[Firejail](https://github.com/netblue30/firejail)** — required for agents to execute shell commands in a sandboxed environment. Install it before running Autopoe if you want agents to be able to run code.

## Configuration

On first run, configure your LLM provider via the Settings panel (gear icon). Three API types are supported — any compatible endpoint works:

- **OpenAI-compatible** — OpenRouter, Ollama, ModelScope, vLLM, LiteLLM, or any `/v1/chat/completions` endpoint
- **Anthropic** — any endpoint following the Anthropic Messages API
- **Google Gemini** — any endpoint following the Gemini `generateContent` API

Settings are saved to `settings.json` and can be changed at runtime without restarting.

## Development

```bash
# Clone the repo
git clone https://github.com/ImFeH2/autopoe.git
cd autopoe

# Backend (hot reload)
uv sync
uv run fastapi dev

# Frontend (hot reload, separate terminal)
cd frontend
pnpm install
pnpm dev
```