How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/smartworldarafath/rea_skill --skill surfsenseBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
SurfSense (Privacy-Focused Research & Document Intelligence)
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 -d2. 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.