Get from zero to a working AI development environment.

Metis is a CLI for scaffolding and evolving local AI development environments for RAG, Agents and MCP.

Install

For local development from the Metis repository:

python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -e .

Once Metis is published to PyPI or Homebrew, replace this with the public installation command.

Quick start

Create an Agent environment:

metis init agent

Start the generated project:

cd my-agent
cp .env.example .env
docker compose up --build

Understand and validate it:

metis inspect
metis doctor

Create a RAG environment

metis init rag

Choose a vector DB, LLM, embedding provider and FastAPI framework. Metis scaffolds the environment and starter wiring; you own chunking, retrieval strategy, prompts and domain logic.

Create an Agent environment

metis init agent

Choose LLM provider, runtime, state and framework. Current state options include none or Redis.

Create an MCP server

metis init mcp-server

Generate a minimal Python MCP server using stdio or streamable HTTP, plus a safe example tool.

Core commands

metis add

Add a capability to an existing Metis-generated project.

metis add rag

Metis inspects what already exists, preserves compatible pieces, adds what is missing, validates the result and updates metadata.

metis inspect

metis inspect

Show the current recipe, selections, capabilities and detected infrastructure.

metis doctor

metis doctor

Check Docker, Compose validity, app health, Qdrant/Chroma, Redis and required provider environment variables when relevant.

Mental model

Metis v0.1 scope

• metis init rag
• metis init agent
• metis init mcp-server
• metis add rag
• metis inspect
• metis doctor