Second-Brain-App

A persistent local web app that turns your Obsidian vault into a queryable second brain with multi-turn chat, automatic ingest, team connectors, and citation-linked browsing.

Table of Contents

• Features
• Architecture
• Quickstart
• First-Run Setup
• Configuration
• Usage Guide
• API Reference
• Operations
• Troubleshooting
• Development
• Project Structure
• Testing
• Contributing
• License

Features

• Multi-turn Ask chat with streaming replies, auto-created conversations, and seed starter questions.
• Personas (9 roles + student grade + addon), per-send corpus / general grounding, optional Brave web search.
• Save to wiki (wiki/analyses/…), rolling memory (context/memory.md), copy on messages, last-send meta strip.
• Sources drawer + optional truthfulness scores and provenance badges on citations.
• Pin / regenerate / edit-fork; Enter to send, Shift+Enter for newline; Vault / Global scope pills.
• Ingest: PDF/DOCX/MD/HTML plus CSV/XLSX, PPTX, IPYNB, common code/IaC; optional vision (settings-gated); cancel + capability header; content-hash skip; browser Cursor-assist pack.
• Team connectors (GitHub, JIRA, Confluence, Slack) with sync progress and “Ask about synced items”.
• Hybrid retrieval (BM25 + vector) with optional reranking; Help link to /observability/dashboard.
• Ollama-first local inference; Light / System / Dark theme; Postgres persistence.

Architecture

Three service deployment: