haiku.rag/examples/README.md
2026-02-13 10:40:36 +02:00

33 lines
1,001 B
Markdown

# 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:
- File monitoring for automatic document indexing
- MCP server for AI assistant integration
See `docker/README.md` for setup instructions.
## Custom Agent
**Script:** `custom_agent.py`
Composes `search`, `qa`, and `document` toolsets into a pydantic-ai `Agent` using `AgentDeps` and `prepare_context`. Shows how to run queries and inspect accumulated state (citations, QA history).
```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 serves an AG-UI streaming endpoint using composed toolsets, `AgentDeps`, and `ToolContextCache` for multi-session support.
```bash
DB_PATH=/path/to/db.lancedb uv run uvicorn examples.custom_agent_agui:app --reload --port 8000
```