298a778889
The list was read in the system's code page. Its about texts hold curly apostrophes, so the packaged app on Windows showed "site’s" in Western code pages and could not read the list at all on cp932 or cp936 systems: the Plugins screen, connecting SurfSense's plugins and adding a custom one all failed. The test writes the apostrophe as raw UTF-8 and fails on a cp1252 Windows machine without the fix. |
||
|---|---|---|
| .agents/skills | ||
| .claude | ||
| .cursor/rules | ||
| .github | ||
| .vscode | ||
| docker | ||
| docs | ||
| plans | ||
| plugins | ||
| scripts | ||
| surfsense_backend | ||
| surfsense_local | ||
| surfsense_mcp | ||
| surfsense_web | ||
| .coderabbit.yaml | ||
| .gitattributes | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .secrets.baseline | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.ar.md | ||
| README.de.md | ||
| README.es.md | ||
| README.fr.md | ||
| README.hi.md | ||
| README.ja.md | ||
| README.ko.md | ||
| README.md | ||
| README.pt-BR.md | ||
| README.ru.md | ||
| README.zh-CN.md | ||
| SECURITY.md | ||
| skills-lock.json | ||
| SurfSense.code-workspace | ||
| VERSION | ||
SurfSense
The air-gapped, open-source NotebookLM alternative.
The AI agent that researches, transforms and edits your documents, on your machine.
Download · Formats · Quick start · Compare · Pricing · Discord
English | العربية | Deutsch | Español | Français | हिन्दी | 日本語 | 한국어 | Português | Русский | 简体中文
https://github.com/user-attachments/assets/88326b9d-e763-46db-9635-75f9df9e8682
SurfSense is a free, open-source desktop app for documents you can't upload. A privacy-focused, NotebookLM-style AI agent that researches, transforms and edits your documents, on your machine. The index stays on your disk, you pick the model, local or remote, and there is no account.
| Platform | Download |
|---|---|
| Windows x64 | SurfSense-Setup.exe |
| macOS Apple Silicon | SurfSense-arm64.dmg |
| Linux x64 | AppImage · deb |
Note
Used the hosted web app? Export your workspaces before 18 October 2026 and import them here. See the sunset page.
Quick start
- Install SurfSense and do the initial onboarding setup.
- Drop your files or folders in your sources.
- Ask the agent to search or extract or edit your files.
What it does with each format
| Format | Research (cited answers) | Create | Edit (as a copy) | Transform |
|---|---|---|---|---|
| ✓ scanned pages too³ | ✓ | Fill and flatten forms; stamp watermarks, page numbers, headers, footers | Merge, split, extract, rotate, reorder pages | |
Word .docx |
✓ | ✓ or from your own .docx as a template |
✓ body text, as tracked changes and comments | To PDF¹ |
Excel .xlsx |
✓ the agent also reads formulas | ✓ with formulas and native charts | ✓ cell values and formulas | Analyse with pandas, chart the results |
PowerPoint .pptx |
✓ | ✓ or from your own .pptx as a template |
Replace text on slides and notes; delete or duplicate slides | To PDF¹ |
| CSV | ✓ | — | — | Analyse with pandas, chart the results |
| Images PNG, JPEG, TIFF, BMP, WebP | ✓ text read by OCR³ | Images and infographics² | — | Place in new documents |
| Markdown, plain text | ✓ | ✓ Markdown | — | — |
| HTML | ✓ | ✓ web page | — | — |
| Podcast (audio) | — | ✓ with a transcript, voiced on your machine by default | — | — |
| Mind maps, flashcards, quizzes | — | ✓ in the app | — | — |
¹ With Office support (LibreOffice), turned on in Settings; it is never in the installer. ² Needs an image model, local or remote; none is chosen by default. ³ OCR reads Latin, Chinese and Japanese script.
Edits, conversions and PDF tools always make a new file; your original is never changed. PDF, Word and Excel do the most today, and support for the other formats keeps improving.
How it compares
| NotebookLM (now Gemini Notebook) | SurfSense | |
|---|---|---|
| Runs offline / air-gapped | No | Yes |
| Your documents leave your machine | Yes | No, unless you pick a remote model |
| Can edit your files | No | Yes |
| Open source | No | Apache-2.0 |
| Models | Gemini only | Any OpenAI-compatible API, or a local one |
Community
- Discord for help, Issues for bugs, Discussions for ideas.
- Contributing: PRs go against
dev; see CONTRIBUTING.md andsurfsense_local/for the dev loop. How it works is indocs/.
Star history
License
Apache-2.0. See LICENSE.