# 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
- A2A agent for conversational interactions

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

## A2A Security Examples

**Directory:** `a2a-security/`

Three examples showing how to add authentication to haiku.rag's A2A server:

### API Key Authentication

**File:** `a2a-security/apikey_example.py`

Simple header-based authentication suitable for internal services and development.

```bash
python examples/a2a-security/apikey_example.py /path/to/database.lancedb
```

### OAuth2 GitHub Authentication

**File:** `a2a-security/oauth2_github.py`

GitHub Personal Access Token authentication for GitHub-integrated services.

```bash
python examples/a2a-security/oauth2_github.py /path/to/database.lancedb
```

### OAuth2 Enterprise Authentication

**File:** `a2a-security/oauth2_example.py`

Full OAuth2 with JWT verification for enterprise environments.

```bash
python examples/a2a-security/oauth2_example.py /path/to/database.lancedb
```

See individual files for detailed setup instructions and usage examples.