haiku.rag/examples/docker

haiku.rag Docker Compose Example

Run haiku.rag with file monitoring, MCP server, and A2A agent.

Quick Start

mkdir -p data docs
cp haiku.rag.yaml.example haiku.rag.yaml  # Edit as needed
docker compose up -d

Place documents in docs/ for automatic indexing.

Usage

# List documents
docker compose exec haiku-rag haiku-rag list

# Search
docker compose exec haiku-rag haiku-rag search "your query"

# Ask questions
docker compose exec haiku-rag haiku-rag ask "What is haiku.rag?"

# A2A interactive client
docker compose exec haiku-rag haiku-rag a2aclient --url http://localhost:8000

Ports

• 8000 - A2A agent
• 8001 - MCP server

Configuration

Edit haiku.rag.yaml to configure providers, embeddings, and other settings. See the Configuration documentation for all options.

Default setup uses Ollama on the host (host.docker.internal:11434).

For API keys (OpenAI, Anthropic, etc.), set them as environment variables:

export OPENAI_API_KEY=your-key-here
export ANTHROPIC_API_KEY=your-key-here
docker compose up -d

Documentation

• Configuration
• CLI Commands
• MCP Server
• A2A Agent