commit 16157367684bb607796e31d33da6e10644ebb869 Author: atlas Date: Wed Jul 1 19:28:13 2026 +0000 add Home diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..c9ec344 --- /dev/null +++ b/Home.md @@ -0,0 +1,39 @@ +# 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: + +```bash +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](https://ollama.com) (`nomic-embed-text`); storage is one portable `brain.db` ([sqlite-vec](https://github.com/asg017/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 +```bash +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 ` | code, docs, config (60+ extensions) | +| Transcripts | `ingest-transcripts ` | `*.jsonl` agent sessions | +| Events | `ingest-events --db ` | structured `events(ts,sense,subject,payload)` | + +Adding a sense is ~10 lines: `chunk → scrub() → _stage()`. + +License: MIT © 2026 Atlas Corporation.