aimarket-metis 0.2.0

Metis — distributed cognitive layer over any LLM

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

Resource	Link
Architecture	EN · RU · ES
API reference	EN · RU · ES
Deployment	EN · RU · ES
Security	EN · RU · ES
User guide	EN · RU · ES
Distributed	EN · RU · ES
Ecosystem	EN · RU · ES
Research	EN · RU · ES
Wiki	Home · Quick Start · FAQ
Landing page	Live demo · docs/landing/index.html · deploy guide
Changelog	CHANGELOG.md · RELEASE.md

Ecosystem map

Project	Role
Metis	Cognitive orchestration layer (this repo)
cognitive-runtime	OpenAI API wrapper with DGPD
ARGUS-3	Demand-side reference agent + WARDEN MCP firewall
AIMarket Hub	Federated capability catalog and invoke API
aimarket-oracle-gateway	Verifiable oracle MCP services
HELIOS	Broadcast pipeline for ecosystem content
AICOM	AI-Factory — autonomous product pipeline

CLI commands

Command	Purpose
metis	Run a query through the cognitive stack
metis-serve	OpenAI-compatible API (/v1/chat/completions)
metis-node	Start a distributed worker node
metis-coordinator	Start the cluster coordinator
metis-cluster	Check cluster node health

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