2 Home
atlas edited this page 2026-07-01 19:35:33 +00:00

SecondBrain

A local-first, privacy-scrubbing personal memory. Point it at everything you produce — notes, code, agent transcripts, event logs — and get one command back:

brain recall "what did we decide about pricing" --hybrid
  • 🔒 Secrets scrubbed before storage — PEM keys, JWTs, sk-…/ghp_…/AWS keys, password:/token= patterns are redacted before a chunk is ever embedded.
  • 🏠 100% local — embeddings via your own Ollama (nomic-embed-text); storage is one portable brain.db (sqlite-vec). No cloud, no API keys, no egress.
  • 🎯 Hybrid recall — dense KNN + FTS5/BM25 fused by reciprocal-rank-fusion, so meaning and exact identifiers (invoice #, IBAN, paths) both hit.
  • 📦 Redeployable anywhere — single file, env-configured, systemd + Docker included.

Pages

  • Architecture — data model, ingestion, scrub guarantees, RRF fusion math
  • Deployment — local, systemd timer, Docker, GPU offload
  • Components-Roadmap — sister components being extracted from the Atlas stack

60-second start

ollama pull nomic-embed-text
git clone https://git.atlascorporation.nl/atlas/secondbrain && cd secondbrain
bash deploy/install.sh && . .venv/bin/activate
python3 brain.py ingest-files ~/notes
python3 brain.py embed
python3 brain.py recall "your question" --hybrid

The senses

Sense Command Ingests
Files ingest-files <dir> code, docs, config (60+ extensions)
Transcripts ingest-transcripts <dir> *.jsonl agent sessions
Events ingest-events --db <sqlite> structured events(ts,sense,subject,payload)

Adding a sense is ~10 lines: chunk → scrub() → _stage().

© 2026 Atlas Corporation. All Rights Reserved. Proprietary software — use only under written agreement with Atlas Corporation. See the repo LICENSE.