> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckbrain.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# DuckBrain

> Local-first DuckDB/DuckLake brain for AI agents — multi-source ingest, hybrid search, one CLI

DuckBrain ingests your personal and work data (Slack, iMessage, Claude Code sessions, markdown notes) into an open **DuckLake** lakehouse on your machine, and gives agents one queryable surface: the `duckbrain` CLI.

## Principles

* **Local-first.** Everything lives at `~/.duckbrain/<instance>/` as SQLite + Parquet. Nothing leaves the machine; embeddings run locally.
* **Raw data is the system of record.** Sources land verbatim in an append-only bronze layer; search indexes are disposable caches rebuilt from the lake.
* **Agents compose simple verbs.** Search-first retrieval with four facet flags — no natural-language parsing inside the CLI.
* **One brain, many attachments.** Instances give hard isolation per agent; workspaces attach with scoped views.

## Quick start

```bash theme={null}
duckbrain init                 # pick platforms, crawlers install automatically
duckbrain ingest slacrawl      # archive → lake
duckbrain embed                # local embeddings (EmbeddingGemma, on-device)
duckbrain index                # rebuild search sidecars
duckbrain search "payroll" --source slack:autono --since 30d
```


## Related topics

- [Granola](/sources/granola.md)
- [Notion](/sources/notion.md)
- [Slack](/sources/slack.md)
- [Gmail & Calendar](/sources/gmail.md)
- [iMessage](/sources/imessage.md)