Based on MODSetter/SurfSense: an air-gapped, privacy-first, open-source NotebookLM alternative. It enables AI agents to research, transform, query, and edit extensive document collections, source notes, and technical literature completely offline or with private LLMs.
🎯 When to Use
- Deep Document Research: Synthesizing architectural patterns, API documentation, and reverse-engineering research notes across large repositories.
- Air-Gapped / Private Analysis: Querying sensitive proprietary specifications, leaked source archives, or internal security reports without external cloud exposure.
- Multi-Source Knowledge Synthesis: Blending Markdown notes, PDFs, web bookmarks, and transcripts into unified, cited technical summaries.
🚀 Setup & Execution
1. Local / Self-Hosted Setup
SurfSense can run entirely locally with Docker or Python:
# Clone the SurfSense repository
git clone https://github.com/MODSetter/SurfSense.git
cd SurfSense
# Quickstart via Docker Compose
docker compose up -d
2. Pairing with Local LLMs (Ollama / LM Studio)
Configure SurfSense to point to local Ollama endpoints for 100% offline document intelligence:
- Base URL:
http://localhost:11434/v1 - Embedding Model:
nomic-embed-textorbge-m3 - Reasoning Model:
llama3.3,qwen2.5-coder, ordeepseek-r1
⚡ Integration with REA & Security Workflows
- Disassembly & Decompiler Notes RAG: When reverse-engineering large binaries with REA, index Ghidra/Hopper decompiled dumps into SurfSense to perform semantic search across millions of lines of recovered pseudocode.
- Vulnerability Case Knowledge Base: Keep a private local repository of past audit reports, CVE advisories, and security notes that can be queried during website security assessments.
- Zero Data Leakage: Ensure proprietary client code or unpublished app data is never indexed in third-party hosted vector stores.