DuckBrain

​

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

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