Skip to content

index.md

Latest commit

 

History

History
70 lines (51 loc) · 3.26 KB

index.md

File metadata and controls

70 lines (51 loc) · 3.26 KB
Raw
title Second Brain User Guide
type landing

Second Brain User Guide

Second Brain is a self-hosted persistent-memory and autonomous-synthesis layer for AI agents. It captures knowledge from your conversations, documents, and feeds, retrieves it by meaning, and autonomously surfaces connections and insights — so your AI agents remember across sessions and think with you over time.

Who this guide is for

You run your own infrastructure and are comfortable with a terminal, PostgreSQL, and Python. You want to understand, install, operate, or extend Second Brain.

Start here

  1. Overview — understand what the system does and how it works.
  2. Getting started — install, configure, and verify.
  3. Connect an AI agent — wire up Kiro CLI or Claude Code.
  4. Your first memory — create, search, and relate a memory.

All pages

Tutorials — learning by doing

Page Description
Getting started Install PostgreSQL, pgvector, and local Ollama BGE-M3; start the MCP server; and verify.
Connect an AI agent Register the MCP server with Kiro CLI or Claude Code.
Your first memory A guided walkthrough: create, search, read, update, and relate a memory.

How-to guides — task-oriented

Page Description
Using Second Brain Day-to-day workflows: writing deep memories, searching, linking, briefings.
Operations Scheduled jobs, backups, SSO refresh, and monitoring.
Upgrade Safely upgrade a running instance.
Troubleshooting Diagnose and fix common issues.

Reference — look it up

Page Description
Reference MCP tools, CLI commands, memory & relationship types, and configuration.
Database schema Every table, column, and index, drawn from the migrations.
Glossary Definitions of project-specific terms.

Explanation — how and why it works

Page Description
Overview What Second Brain is and the five-stage data flow.
Architecture How the components fit together.
How memory works Embeddings, hybrid search, RRF, and the reranking formula.
Dream cycle design Why and how the autonomous nightly synthesis works.
Security model Threat model, trust boundaries, encryption, and secret handling.

Contributing

Page Description
Style guide Voice, formatting, terminology, and structure conventions.
Contributing How to add or edit guide pages.

Engineering architecture

Page Description
Architecture Component Index Canonical ownership, contracts, runtime flows, code entry points, tests, and operational status for every component.
Architecture decisions Durable decisions governing capture, provenance, segmentation, testing, and Correction Episodes.