Metis

Metis (μῆτις) — distributed cognitive layer over any LLM
Part of the alexar76 AI agent economy

_{Grab the star · watch it pulse and think · chat with Metis — open the live demo →}

🌐 Language: English · Русский · Español

Multi-agent reasoning orchestrator — Understanding Council, DGPD depth gating, layered MoA, verifier, memory, search, economy metering, distributed cluster, MCP tools, and OpenAI-compatible API.

Quick start

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev,distributed]"
ollama pull qwen3:8b
metis "Explain multi-agent systems" --model qwen3:8b --url http://localhost:11434/v1

Install

PyPI package name is aimarket-metis (the PyPI name metis is a different project). Import path and CLI stay metis, metis-serve, etc.

# PyPI
pip install aimarket-metis
pip install "aimarket-metis[dev,distributed]"

# GitHub release tag
pip install "aimarket-metis[distributed] @ git+https://github.com/alexar76/metis.git@v0.2.0"

# Clone / monorepo (editable)
git clone https://github.com/alexar76/metis.git && cd metis
pip install -e ".[dev,distributed]"

# Docker
docker compose up -d

Documentation index

Ecosystem map

CLI commands

Architecture

flowchart LR
    Q["Query"] --> M["Metis"]
    M --> R["Router"]
    R --> C["Council/MoA/Agent"]
    C --> P["LLM Providers"]
    C --> T["Tools + MCP"]
    M --> E["Economy Meter"]

Production

export METIS_API_KEY=sk-...
metis-serve --config config.production.yaml --production --port 8080

Legacy env vars SUPERBRAIN_* and COGNITIVE_* are still read for one release cycle.

Docker

cp config/docker.env.example .env
docker compose up -d --build

Tests

pytest --cov=metis --cov-report=term-missing -v

Research citations

Design decisions are grounded in published work — see docs/en/RESEARCH.md for Yang et al. 2026 (heterogeneous agents), Wang et al. ICLR 2025 (layered MoA), and related citations with honest caveats.

MIT License