Sponsor
Atlas Cloud is a full-modal AI inference platform that gives developers a single AI API to access video generation, image generation, and LLM APIs. Instead of managing multiple vendor integrations, you connect once and get unified access to 300+ curated models across all modalities. Check out Atlas Cloud's new coding plan promotion for more budget-friendly API access: https://www.atlascloud.ai/console/coding-plan
Second Brain Example
For an example of what Second Brain can do, visit https://second-brain.art! It's an interactive art exhibition.
Head-to-Head Evaluation
Second Brain performs higher than OpenClaw and Hermes on harness-bench, which measures "model-harness configuration effects across 106 sandboxed offline agent tasks". Here are the results:
The full evaluation framework I used is available on GitHub, and the full results are available here. I did this testing because I was curious how Second Brain would stack up against other agents. This provides the real results, but with a few small caveats, which you can read in the links provided.
What you get
How Second Brain works, in infographic form
1. Attachment Parsing
2. File Parsing
3. The LLM Loop
4. Path-Driven Tasks
5. Event-Driven Tasks
6. Conversation Runtime
7. Frontends
8. Commands
9. Plugins
10. Sandbox & SDK
Install
Second Brain runs on your own machine. Two things to install: the app (required, ~2 minutes) and the UI (optional, a ChatGPT-style web app you can add to your phone's home screen).
1. Install the app
You need Python 3.11+ and git.
git clone https://github.com/henrydaum/second-brain
cd second-brain
python -m venv .venv
Activate the virtual environment:
| Windows | .venv\Scripts\activate |
| macOS / Linux | source .venv/bin/activate |
Then install and run:
pip install -r requirements.txt
python main.py
That's it — you're in the REPL. requirements.txt is nearly pure Python.
There's also a Dockerfile, if you'd rather not install anything:
docker build -t second-brain .
docker run --rm -it --init -v sb-data:/data second-brain
Same REPL, with everything kept in the sb-data volume. The path above is
still the better one for day-to-day use — Second Brain is an assistant for
your machine, and a container starts out unable to see it. Reach for this
when the machine isn't one you want to install on: a server or a NAS, or a
reproducible Linux to test against. docs/DOCKER.md covers it,
including Docker itself if this is your first time.
2. Run /setup
/setup
The wizard walks you through everything in one pass:
- Install the
essentialsbundle — an LLM backend, file read/edit/search, shell and script running, SQL, web search, subagents, and the Telegram frontend. - Connect a model — paste an API key. Atlas Cloud is the sponsored fast path (300+ models behind one key), but any provider works.
- Telegram (optional) — chat with your Second Brain from your phone. Needs a bot token from @BotFather and your user ID from @userinfobot.
- Web UI (optional) — installs the HTTP frontend and generates your API token, then prints the exact steps to set the app up. More below.
Say hello. You now have a working assistant. If you have questions, just ask.
3. Get out of the terminal
The REPL works, but it isn't where you want to live. Two much nicer options, in order of effort:
| Effort | What it's like | |
|---|---|---|
| Telegram | ~5 minutes — /setup shows the way |
Push notifications, attachments, inline buttons, and available on all major platforms. |
| Web UI | ~10 minutes | A ChatGPT-style app you open in a browser or add to your phone's home screen. Set it up below. |
Skipped one during /setup? Just run /setup again.
4. Add more (optional)
A fresh install is deliberately small. Add capabilities whenever you want:
/packages install
On the Web UI, you can do this in Settings. That opens a picker — browse by category and choose. The bundles worth knowing:
| Bundle | What you get |
|---|---|
bundle_knowledgebase |
Index and search your own files — PDF, Office, images, audio, video, spreadsheets, archives. OCR, transcription, embeddings, and three search tools. Large download. |
bundle_memory |
Durable memory that maintains itself. Notes and skills are surfaced when relevant and written down in the background, as plain markdown you can edit. |
bundle_gmail |
Read, send, reply, label. |
Then tell it which folders to watch:
/config
Set sync_directories to the folders you want indexed. Expect a flood of task messages while the first sync runs — that's normal, and it stops when it finishes.
Install the UI
The UI lives in this repo, in frame_ui/. It is being rebuilt: right now it is a page that connects and prints what the kernel sends, not yet a chat interface. The previous UI — a React app on assistant-ui, in its own repo at second-brain-ui — still works and is still the one to use if you want a finished app today.
Works on Windows, macOS and Linux. Takes about two minutes.
Before you start: Second Brain has to be running while you use the UI — the UI is just a face for it. Leave it going in its terminal and open a second terminal for everything below. You'll also need Node 20.19+ or 22.12+.
1. Turn the HTTP frontend on
If you said yes to the web UI during /setup, this is already done — skip to step 2. Otherwise, in the Second Brain REPL:
/frontends enable http
/restart
There is no token to set. Second Brain mints secret_http_token at boot and the UI reads it out of config.json itself, so nothing gets copied anywhere.
2. Install the UI's dependencies
Once, in your second terminal:
cd frame_ui
npm install
(frame_ui is in your Second Brain folder — the same