Installation¶

From PyPI¶

pip install distill-mcp

For GCP backend support:

pip install distill-mcp[gcp]

git clone https://github.com/5queezer/distill.git
cd distill
uv sync

Distill requires two Ollama models:

ollama pull gemma3:4b          # distillation (raw text → anonymous fact)
ollama pull nomic-embed-text   # embeddings (768-dim vectors for search)

You can override these with environment variables:

export DISTILL_MODEL=gemma3:4b          # any Ollama model
export EMBEDDING_MODEL=nomic-embed-text # must produce 768-dim vectors

# From PyPI install
claude mcp add distill -- python -m distill_mcp

# From source
claude mcp add distill -- uv run python -m distill_mcp

Run the MCP Inspector to test tools interactively:

fastmcp dev src/distill_mcp/server.py

All settings are controlled via environment variables. See the Configuration reference for the full list.