# haiku.rag Examples

This directory contains example scripts demonstrating various features of haiku.rag.

## Docker Example

**Directory:** `docker/`

Complete Docker setup for running haiku.rag with all services:
- Continuous ingestion from a watched directory via `haiku-ingester`
- MCP server for AI assistant integration

See `docker/README.md` for setup instructions.

## Custom Agent

**Script:** `custom_agent.py`

Uses the eagerly loaded RAG capability to build a conversational agent.

```bash
uv run python examples/custom_agent.py /path/to/db.lancedb
```

## Custom Agent with AG-UI Streaming

**Script:** `custom_agent_agui.py`

A Starlette app that adapts a native RAG-capable agent to AG-UI. The configuration places the database (`HAIKU_RAG_CONFIG_PATH`, or `./haiku.rag.yaml`):

```bash
uv run uvicorn examples.custom_agent_agui:app --reload --port 8000
```