smartworldarafath/rea_skill

surfsense

Air-gapped, privacy-focused AI research assistant and NotebookLM alternative (MODSetter/SurfSense).

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/smartworldarafath/rea_skill --skill surfsense

Before 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.
Original skill document

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:

bash
# 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-text or bge-m3
  • Reasoning Model: llama3.3, qwen2.5-coder, or deepseek-r1

⚡ Integration with REA & Security Workflows

  1. 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.
  2. 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.
  3. Zero Data Leakage: Ensure proprietary client code or unpublished app data is never indexed in third-party hosted vector stores.
from this repository

More skills

All skills
smartworldarafath
Community

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

1h installs
2
GitHub stars
5
Updated
Nov 8
smartworldarafath
Community

agent-reach

Read-only access to internet platforms (Twitter/X, Reddit, YouTube subtitles, GitHub, LinkedIn, Bilibili, web). Use when the agent needs to search, read web links, retrieve social discussions, CVE/vulnerability intel, or when standard web search/fetch is blocked or insufficient.

1h installs
2
GitHub stars
5
Updated
Nov 8
smartworldarafath
Community

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

1h installs
2
GitHub stars
5
Updated
Nov 8
smartworldarafath
Community

anti-ai-slop-writing

Produces human-sounding text that avoids detectable AI writing patterns. Activates on any writing task — tweets, emails, articles, bios, captions, reports, copy, messages, LinkedIn posts, cover letters, README files, or any content where the output must not read as AI-generated. Enforces banned vocabulary, structural variety, punctuation discipline, accuracy rules, and voice calibration. Use when the user says "write," "draft," "rewrite," "make this sound human," "anti-slop," "not AI," or any va

1h installs
2
GitHub stars
5
Updated
Nov 8