# DuckBrain

> Local-first DuckDB/DuckLake brain for AI agents

## Docs

- [For Agents](https://docs.duckbrain.sh/agents.md): How AI agents should use duckbrain: search-first, filter-first, hydrate last
- [context](https://docs.duckbrain.sh/commands/context.md): Assemble a prompt-ready context block, filled to a budget
- [doctor](https://docs.duckbrain.sh/commands/doctor.md): Health check: versions, instance, row counts
- [embed](https://docs.duckbrain.sh/commands/embed.md): Generate local embeddings for everything in the lake
- [eval](https://docs.duckbrain.sh/commands/eval.md): The thesis harness: golden questions vs baselines
- [index](https://docs.duckbrain.sh/commands/index.md): Rebuild the search sidecars from the lake
- [ingest](https://docs.duckbrain.sh/commands/ingest.md): Pull a source archive into the lake — append-only, idempotent
- [init](https://docs.duckbrain.sh/commands/init.md): Create a brain instance and pick your platforms
- [search](https://docs.duckbrain.sh/commands/search.md): Ranked search with facet filters and snippets
- [sync](https://docs.duckbrain.sh/commands/sync.md): Run the whole loop once: crawlers → ingest → embed → index → maintenance
- [DuckBrain](https://docs.duckbrain.sh/index.md): Local-first DuckDB/DuckLake brain for AI agents — multi-source ingest, hybrid search, one CLI
- [Install](https://docs.duckbrain.sh/install.md): Install the duckbrain CLI from a checkout
- [Instances](https://docs.duckbrain.sh/instances.md): One brain per instance — hard physical isolation for multi-agent setups
- [Search & Facets](https://docs.duckbrain.sh/search.md): Four-facet retrieval: who, where, when, source — plus ranking modes
- [Apple Photos](https://docs.duckbrain.sh/sources/apple-photos.md): Apple Photos → DuckBrain ingest (Planned)
- [Claude Code Sessions](https://docs.duckbrain.sh/sources/claude-sessions.md): Claude Code Sessions → DuckBrain ingest (Available)
- [GitHub](https://docs.duckbrain.sh/sources/github.md): GitHub → DuckBrain ingest (Planned)
- [Gmail & Calendar](https://docs.duckbrain.sh/sources/gmail.md): Gmail & Calendar → DuckBrain ingest (Planned)
- [Granola](https://docs.duckbrain.sh/sources/granola.md): Granola → DuckBrain ingest (Planned)
- [iMessage](https://docs.duckbrain.sh/sources/imessage.md): iMessage → DuckBrain ingest (Planned)
- [Markdown & Notes](https://docs.duckbrain.sh/sources/markdown.md): Markdown & Notes → DuckBrain ingest (Available)
- [Notion](https://docs.duckbrain.sh/sources/notion.md): Notion → DuckBrain ingest (Planned)
- [Sources Overview](https://docs.duckbrain.sh/sources/overview.md): Sources Overview → DuckBrain ingest (Reference)
- [Slack](https://docs.duckbrain.sh/sources/slack.md): Slack → DuckBrain ingest (Available)
- [WhatsApp](https://docs.duckbrain.sh/sources/whatsapp.md): WhatsApp → DuckBrain ingest (Planned)