Second Brain
Local knowledge vault CLI with hybrid search, entity graph, and MCP access to notes.
Tested on Linux
Use it
Linux x86_64
install via uv tool install secondbrain-py
uv tool install secondbrain-py
Where the README and reality differ
- README: brain search "platform migration" --json --brief
What worked: installed brain 0.3.0 has no --brief flag; `brain search` rejects it with `No such option: --brief (Possible options: --before)`
Check that it works
brain --version 2>&1The output should contain “brain 0.3.0”.
First thing to try
brain doctor 2>&1Run brain doctor first to check your setup.
What it does
- Search notes with combined keyword and vector searchNot tested
- Explore the entity graph built from your notesNot tested
- Enrich notes using a local LLMNot tested
- Query your knowledge base through an MCP serverNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Good for
- ingest a file into the knowledge base
- hybrid search notes and transcripts
- get a cited multi-hop answer from the corpus
- generate a digest of newly landed notes
- resurface older notes due for review
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.3.0
Differences the test machine hit
- README: brain demo needs only Docker; setup provisions Postgres container on 55432
In the test: Docker Engine must be installed and running; box has no docker so `brain demo`, `brain setup` and DB-backed search cannot run