vrr/SurfSense
2
0
Fork 0
mirror of https://github.com/MODSetter/SurfSense.git synced 2026-10-19 07:34:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: update AGENTS.md and README files with new language links and sunset details

Browse source 
- Clarified the status of the hosted service in AGENTS.md, including data purge dates.
- Updated language links in README files to include additional languages: Arabic, German, French, Japanese, Korean, and Russian.
- Adjusted README comments regarding sunset callout consistency across localized versions.
This commit is contained in:
DESKTOP-RTLN3BA\$punk 2026-09-22 22:08:49 -07:00
parent 35839cf9ff
commit 2cb3510f9b
12 changed files with 1048 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

20
AGENTS.md
View file

@ -13,7 +13,7 @@ Desktop app plus scraper API. Four trees:
| `surfsense_local` | Electron desktop |
| `surfsense_mcp` | MCP server over the REST API |
Hosted Azure still ships until after launch. Product direction is local + API.
The hosted service has been export-only since the 2.0.0 launch on 18 Sep 2026, and its user data is purged on 18 Oct 2026 ([sunset](docs/architecture/sunset.md)). Product direction is local + API.
## Code organization
@ -63,7 +63,7 @@ cd surfsense_local/electron && pnpm dev
# MCP
cd surfsense_mcp && uv sync
# compose (hosted still uses this until after launch)
# compose (dev and self-host, not production)
docker compose -f docker/docker-compose.yml
# hooks
@ -83,6 +83,16 @@ pre-commit run --all-files
CI: `.github/workflows/`. New behavior: one failing test, then the minimum code to pass it. Use the `tdd` skill. Tests hit public seams, not internals.
## Pull requests
Follow [CONTRIBUTING.md](CONTRIBUTING.md). The parts agents miss:
- Open PRs against `dev`. `gh pr create` targets the default branch, `main`, unless you pass `--base dev`.
- `gh pr create --body` skips the PR template. Keep its headings: What, Why, `Fixes #`, How to test.
- Commit messages and PR titles are Conventional Commits, `type(scope): summary`. The commitizen hook runs only where it is installed; CI does not run it.
- A new feature starts as a proposal PR in `docs/proposals/`, not as code.
- `surfsense_backend/app/proprietary/` is Business Source License 1.1: ask a maintainer before changing it. A change to `docs/contracts/` needs the owners of both sides.
## Skills
Canonical dir: `.agents/skills/`. `.claude/skills` is a symlink to it.
@ -117,10 +127,10 @@ its lock entry is valid.
## Boundaries
- Do not carve hosted code out of backend/web until after launch.
- Do not drop SearxNG, sandbox, OpenSandbox, or zero-cache from compose until a new compose is defined after launch.
- Do not carve hosted code out of backend/web until the purge on 18 Oct 2026. The export window and the purge script run on that code until then.
- Do not drop SearxNG, sandbox, OpenSandbox, or zero-cache from compose until a new compose is defined.
- Edit the root `README.md` directly. The draft at `plans/community-local/seo/drafts/README.md` shipped on 18 Sep 2026 and is kept only for history. Anything added to the README replaces something — its length was measured against the eight biggest repos in this category.
- Do not commit unless asked.
- Do not commit, push or open a PR unless asked.
## Security

171
README.ar.md Normal file
View file

@ -0,0 +1,171 @@
<!--
ملاحظة الإيقاف محدودة بزمن. احذفها في 18 أكتوبر 2026 عند إغلاق نافذة
التصدير، مع رابط «الاستيراد من التطبيق المستضاف» في الأسفل.
هذا الملف يتابع README.md قسمًا بقسم.
مسوغ هذه الصفحة: plans/community-local/seo/06-repo-readme.md
-->
<div align="center">
[![Stars](https://img.shields.io/github/stars/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/stargazers)
[![Forks](https://img.shields.io/github/forks/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/network/members)
[![Latest release](https://img.shields.io/github/v/release/MODSetter/SurfSense?sort=semver)](https://github.com/MODSetter/SurfSense/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Discord](https://img.shields.io/discord/1359368468260192417?label=Discord)](https://discord.gg/ejRNvftDp9)
<a href="https://www.surfsense.com/"><img width="128" height="128" alt="SurfSense، بديل NotebookLM مفتوح المصدر والمعزول عن الشبكة" src="surfsense_web/public/homepage/icon.png" /></a>
<h1>SurfSense</h1>
<p>
<b>بديل NotebookLM المفتوح المصدر، المعزول عن الشبكة.</b>
<br />
المستندات التي لا يمكن رفعها تصير إحاطات وعروض شرائح وتقارير وأدلة دراسة وبودكاست، بالكامل على الجهاز نفسه.
</p>
<p>
<a href="https://www.surfsense.com/downloads"><b>تنزيل</b></a> ·
<a href="https://www.surfsense.com/docs">التوثيق</a> ·
<a href="#ما-يصنعه-surfsense">ما يصنعه</a> ·
<a href="#كيف-يقارن-surfsense">المقارنة</a> ·
<a href="https://www.surfsense.com/pricing">الأسعار</a> ·
<a href="https://discord.gg/ejRNvftDp9">Discord</a>
</p>
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | العربية | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>
<p align="center">
<img src="surfsense_web/public/homepage/offline-studio.png" alt="تطبيق SurfSense لسطح المكتب مع Studio مفتوحًا وQwen محددًا، يحوّل المصادر المحلية إلى مخرجات" />
</p>
SurfSense تطبيق سطح مكتب مجاني ومفتوح المصدر للمستندات الموجودة أصلًا. تُلقى في التطبيق، وتُطرح الأسئلة، وتأتي الإجابات مع ذكر المصدر، ثم تصير المستندات نفسها إحاطة أو عرض شرائح أو تقريرًا أو دليل دراسة أو بودكاست. كل ذلك يجري على الجهاز: الفهرس يقيم على القرص، والنموذج يُختار هناك، والتطبيق لا يرفع شيئًا. لا حساب يُنشأ.
**للبدء.** يُنزَّل برنامج التثبيت المناسب للجهاز، ثم يُؤتى بمفتاح نموذج خاص أو يُترك للتطبيق جلب نموذج محلي.
| المنصة | التنزيل |
|---|---|
| **Windows** x64 | [SurfSense-Setup.exe](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-Setup.exe) |
| **macOS** Apple Silicon | [SurfSense-arm64.dmg](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-arm64.dmg) |
| **Linux** x64 (AppImage) | [SurfSense.AppImage](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.AppImage) |
| **Linux** x64 (deb) | [SurfSense.deb](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.deb) |
كل رابط دائم ويشير إلى أحدث إصدار. يمكن أيضًا الاختيار من [surfsense.com/downloads](https://www.surfsense.com/downloads) أو تصفح [كل الإصدارات](https://github.com/MODSetter/SurfSense/releases). يحدّث AppImage نفسه تلقائيًا، وdeb لا يفعل.
> [!NOTE]
> **هل استُخدم تطبيق الويب المستضاف؟** يجري إيقافه. يُفتح مرة واحدة لتصدير مساحات العمل، ثم تُستورد الحزمة إلى تطبيق سطح المكتب. تنتقل المستندات والمجلدات والعناوين وسلاسل المحادثة كلها. تغلق نافذة التصدير في 18 أكتوبر 2026. التفاصيل في [صفحة الإيقاف](https://www.surfsense.com/sunset).
## ما يصنعه SurfSense
تُختار بضعة مستندات وصيغة. التطبيق يكتب الناتج من المصادر المختارة، على الجهاز.
| الصيغة | الناتج | يلزم |
|---|---|---|
| **ملخص** | إحاطة منظمة للمصادر المحددة | نموذج توليد |
| **بطاقات** | مجموعة تفاعلية، بطاقة واحدة في كل مرة | نموذج توليد |
| **اختبار** | أسئلة اختيار من متعدد مع الإجابات | نموذج توليد |
| **خريطة ذهنية** | Markmap تُكبَّر وتُطوى | نموذج توليد |
| **شرائح** | ملف `.pptx` قابل للتحرير، لا صورة لعرض | نموذج توليد |
| **مستند** | تقرير `.docx` قابل للتحرير | نموذج توليد |
| **جدول** | ملف `.xlsx` للجداول المستخرجة من المصادر | نموذج توليد |
| **صفحة ويب** | صفحة HTML مكتفية بذاتها | نموذج توليد |
| **PDF** | PDF منضّد | نموذج توليد |
| **بودكاست** | حوار صوتي بين مضيفين، بصوت Kokoro-82M من دون شبكة | نموذج توليد + صوت مرفق |
| **صورة** | رسم توضيحي للمادة | نموذج صور + نموذج توليد |
| **إنفوجرافيك** | ملخص بصري في لوحة واحدة | نموذج صور + نموذج توليد |
بعض المهام تحتاج أكثر من صيغة. دليل الدراسة ملخص ومجموعة بطاقات واختبار على مجموعة المصادر نفسها، وإحاطة العميل في العادة هي العرض الذي يُقدَّم منه مع الملخص الذي يُرسل بعده. عروض الفيديو لم تُبنَ بعد.
## كل شيء يبقى على الجهاز نفسه
يُوجَّه هذا إلى أوراق القضايا، وأوراق عمل العملاء، وتفريغات المقابلات، والمواصفات الداخلية، والبحث غير المنشور، وملاحظات محاضرات فصل دراسي كامل. يمكن السؤال عبر ذلك كله، وكل إجابة تذكر المصدر الذي جاءت منه. التطبيق لا يرفع شيئًا منه.
- **الفهرس محلي.** يجري التحليل والتقسيم إلى مقاطع والتضمين على الجهاز، في SQLite تحت `~/.surfsense`. لا يحتفظ SurfSense بنسخة منه ولا بسجل لما طُرح من أسئلة.
- **كل دور يمكن أن يعمل محليًا.** محلّل المستندات ونموذج الاسترجاع وصوت البودكاست داخل برنامج التثبيت. المحادثة وتوليد الصور يأتيان كخوادم محلية تُنزَّل أوزانها مرة واحدة، فيصير إنتاج النص والصوت والصور ممكنًا بلا حساب وبلا مفتاح API. نختبر ذلك بإدخال PDF والشبكة معطّلة.
- **الاتصالات الصادرة مطفأة افتراضيًا.** لوحة الاتصالات الخارجة تسرد كل وجهة يستطيع التطبيق بلوغها، ويُفعَّل منها ما يُراد.
- **لا تتبّع للاستخدام ولا تقارير أعطال.** لا شيء يرسل بيانات إلى الخارج، فلا يوجد خيار إيقاف يجب العثور عليه.
لا يستطيع SurfSense أن يقول إن كان هذا يستوفي لائحة بعينها. ذلك يتوقف على الضوابط القائمة وعلى الجهة الرقابية. كل ما يستطيع التطبيق قوله هو على أي جهاز تقع المستندات.
## كيف يقارن SurfSense
ثلاثة أنواع من المنتجات تُدعى «NotebookLM المحلي»، وهي تجيب عن أسئلة مختلفة. لا أداة منها سيئة. ما يبقى في اليد في النهاية مختلف.
**مقابل Jan وAnythingLLM وOpen WebUI وLM Studio.** هذه تشغّل نموذجًا محليًا وتتيح مكانًا للحديث معه. SurfSense يجيب عن السؤال التالي: كيف يخرج مستند جاهز؟ يمكن الجمع بينها بتوجيه SurfSense إلى أي نقطة اتصال متوافقة مع OpenAI، بما فيها نقطة منها.
**مقابل RemNote وQuizlet وNoteGPT وStudyFetch وGamma.** هذه تنتج مخرجات، وبعضها يبدو أفضل من مخرجاتنا. المقابل هو مصير المادة: تُرفع، ويُدفع كل شهر، وتبقى الملفات في حساب طرف آخر.
**مقابل Google NotebookLM.** هو يقدّم أصلًا بطاقات واختبارات وخرائط ذهنية وعروضًا صوتية، فالطرفان ينتجان أشياء متقاربة جدًا. الفرق هو جهاز من يقوم بالعمل، وأي نموذج يمكن توجيهه إليه.
| | Google NotebookLM | SurfSense |
|---|---|---|
| يعمل بلا اتصال / معزول عن الشبكة | لا | **نعم** |
| المستندات تغادر الجهاز | نعم | **لا** |
| الحساب مطلوب | حساب Google | **لا حساب** |
| مفتوح المصدر | لا | **Apache-2.0** |
| السعر | المستوى المجاني; Pro $19.99 في الشهر; Ultra $249.99 في الشهر | **التطبيق مجاني** |
| النماذج | Gemini فقط | أي API متوافقة مع OpenAI، أو نموذج محلي |
| حدود المصادر | 50 إلى 600 مصدر، 500,000 كلمة لكل منها | ما يتسع له القرص |
| العروض الصوتية والمرئية | نعم، وأفضل | الصوت نعم، بلا شبكة; الفيديو ليس بعد |
يتفوق NotebookLM في جودة الصوت، ولديه فيديو. إن كان بقاء المصادر على خوادم Google مقبولًا، فالاستخدام له. وإن لم يكن مقبولًا، فهذه الأداة من النوع نفسه بلا رفع.
## بداية سريعة
لا حاجة إلى Docker ولا إلى طرفية ولا إلى GPU ولا إلى ملف Compose.
1. **تنزيل برنامج التثبيت** من الجدول أعلاه. هو موقّع، لذلك لن يخاصم نظام التشغيل.
2. **اختيار نموذج.** يجلب التطبيق نموذجًا محليًا (Qwen3 في ستة أحجام، من 0.5 GB) أو يُلصق عنوان أساس ومفتاح لأي API متوافقة مع OpenAI. يتحقق المنتقي من قدرة الجهاز على تشغيل النموذج قبل عرضه، وأي مفتاح يُعطى يُخزَّن مشفّرًا، والسر في سلسلة مفاتيح نظام التشغيل.
3. **إلقاء المستندات.** التطبيق يحلّل ملفات PDF وملفات Office والصور على الجهاز.
4. **طرح الأسئلة.** كل إجابة تذكر المصدر الذي جاءت منه.
5. **فتح Studio،** اختيار صيغة، وأخذ الملف.
التنزيل هو الجزء البطيء، لأن برنامج التثبيت يحمل المحلّل ونموذج الاسترجاع وصوت البودكاست وخوادم النماذج المحلية، فيعمل التطبيق من دون شبكة.
## التوثيق والمجتمع
التطبيق مجاني، وتحديثاته مجانية. الترخيص يضيف إضافات ودعمًا بأولوية ولا يغلق غير ذلك، فالترخيص المنتهي يُبقي التطبيق وكل تحديث لاحق. التفاصيل في [الأسعار](https://www.surfsense.com/pricing).
حزمة Docker في هذا المستودع (`surfsense_backend`, `surfsense_web`, ملفات Compose) تبقى مفتوحة المصدر وقابلة للتثبيت، وهي **بدعم المجتمع: بلا اتفاقية مستوى خدمة وبلا خدمة مستضافة وراءها.** تطبيق سطح المكتب هو المسار المدعوم للمستخدمين الجدد.
- [التوثيق](https://www.surfsense.com/docs) للتثبيت والنماذج وصيغ Studio والاستضافة الذاتية
- [الاستيراد من التطبيق المستضاف](https://www.surfsense.com/sunset)
- [خادم MCP](./surfsense_mcp) لواجهة API الكشط المستضافة
- [Discord](https://discord.gg/ejRNvftDp9) للمساعدة والأفكار، و[Discussions](https://github.com/MODSetter/SurfSense/discussions) للاتجاه، و[Issues](https://github.com/MODSetter/SurfSense/issues) للأعطال القابلة لإعادة الإنتاج
- **نجمة للمستودع** لمن يتابع إلى أين يمضي هذا
## المساهمة
طلبات السحب مرحّب بها، و[CONTRIBUTING.md](CONTRIBUTING.md) يشرح المسار كله. باختصار:
- **إيجاد عمل:** بلاغ بوسم [`good first issue`](https://github.com/MODSetter/SurfSense/labels/good%20first%20issue) أو [`help wanted`](https://github.com/MODSetter/SurfSense/labels/help%20wanted)، أو سطر من قائمة Known gaps (الفجوات المعروفة) في نهاية كل مستند ضمن [`docs/architecture/`](docs/architecture/overview.md).
- **قراءة طريقة العمل أولًا:** [`docs/`](docs/README.md) يشرح كل ميزة ولماذا بُنيت هكذا، و[`docs/ROADMAP.md`](docs/ROADMAP.md) يُظهر ما يعمل عليه المشرفون.
- **فتح طلب سحب على `dev`.** إصلاح الأعطال والتوثيق لا يحتاجان نقاشًا قبل ذلك. الميزة الجديدة تبدأ بمقترح تصميم قصير. تطبيق سطح المكتب يعيش في [`surfsense_local/`](./surfsense_local)، وملف README هناك يغطي حلقة التطوير.
شكرًا لكل Surfers لدينا:
<p align="center">
<a href="https://github.com/MODSetter/SurfSense/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MODSetter/SurfSense" alt="SurfSense contributors" />
</a>
</p>
## تاريخ النجوم
<p align="center">
<a href="https://www.star-history.com/#MODSetter/SurfSense&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
</picture>
</a>
</p>
## الرخصة
Apache-2.0. التفاصيل في [LICENSE](LICENSE).

171
README.de.md Normal file
View file

@ -0,0 +1,171 @@
<!--
Der Abschaltungshinweis ist befristet. Lösche ihn am 18. Oktober 2026, wenn
das Exportfenster schließt, zusammen mit dem Link „Import aus der gehosteten
App“ weiter unten. Diese Datei folgt README.md Abschnitt für Abschnitt.
Begründung dieser Seite: plans/community-local/seo/06-repo-readme.md
-->
<div align="center">
[![Stars](https://img.shields.io/github/stars/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/stargazers)
[![Forks](https://img.shields.io/github/forks/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/network/members)
[![Latest release](https://img.shields.io/github/v/release/MODSetter/SurfSense?sort=semver)](https://github.com/MODSetter/SurfSense/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Discord](https://img.shields.io/discord/1359368468260192417?label=Discord)](https://discord.gg/ejRNvftDp9)
<a href="https://www.surfsense.com/"><img width="128" height="128" alt="SurfSense, die netzgetrennte Open-Source-Alternative zu NotebookLM" src="surfsense_web/public/homepage/icon.png" /></a>
<h1>SurfSense</h1>
<p>
<b>Die netzgetrennte Open-Source-Alternative zu NotebookLM.</b>
<br />
Mach aus Dokumenten, die du nicht hochladen kannst, Briefings, Folien, Berichte, Lernleitfäden und Podcasts, vollständig auf deinem eigenen Rechner.
</p>
<p>
<a href="https://www.surfsense.com/downloads"><b>Download</b></a> ·
<a href="https://www.surfsense.com/docs">Dokumentation</a> ·
<a href="#was-surfsense-erstellt">Was es erstellt</a> ·
<a href="#so-vergleicht-sich-surfsense">Vergleich</a> ·
<a href="https://www.surfsense.com/pricing">Preise</a> ·
<a href="https://discord.gg/ejRNvftDp9">Discord</a>
</p>
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | Deutsch | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>
<p align="center">
<img src="surfsense_web/public/homepage/offline-studio.png" alt="Die SurfSense-Desktop-App mit geöffnetem Studio und ausgewähltem Qwen, die lokale Quellen in Ergebnisse verwandelt" />
</p>
SurfSense ist eine kostenlose Open-Source-Desktop-App für die Dokumente, die du schon hast. Zieh sie hinein, stell Fragen und bekommst Antworten, die ihre Quelle nennen. Dieselben Dokumente werden daraus ein Briefing, eine Folienpräsentation, ein Bericht, ein Lernleitfaden oder ein Podcast. Alles läuft auf deinem eigenen Rechner: Der Index liegt auf deiner Festplatte, du wählst das Modell, und die App lädt nichts hoch. Ein Konto brauchst du nicht.
**Loslegen.** Lade das Installationsprogramm für deinen Rechner herunter. Danach bringst du einen eigenen Modellschlüssel mit oder lässt die App ein lokales Modell für dich holen.
| Plattform | Download |
|---|---|
| **Windows** x64 | [SurfSense-Setup.exe](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-Setup.exe) |
| **macOS** Apple Silicon | [SurfSense-arm64.dmg](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-arm64.dmg) |
| **Linux** x64 (AppImage) | [SurfSense.AppImage](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.AppImage) |
| **Linux** x64 (deb) | [SurfSense.deb](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.deb) |
Jeder Link zeigt dauerhaft auf die neueste Version. Du kannst auch auf [surfsense.com/downloads](https://www.surfsense.com/downloads) wählen oder [alle Versionen](https://github.com/MODSetter/SurfSense/releases) durchsehen. Das AppImage aktualisiert sich selbst, das deb nicht.
> [!NOTE]
> **Die gehostete Web-App genutzt?** Sie wird eingestellt. Öffne sie einmal, exportiere deine Arbeitsbereiche und importiere das Paket in die Desktop-App. Dokumente, Ordner, Titel und Chatverläufe kommen mit. Das Exportfenster schließt am 18. Oktober 2026. Details auf [der Abschaltungsseite](https://www.surfsense.com/sunset).
## Was SurfSense erstellt
Wähl ein paar Dokumente und ein Format. Die App schreibt das Ergebnis aus den Quellen, die du ausgewählt hast, auf deinem Rechner.
| Format | Was du bekommst | Braucht |
|---|---|---|
| **Zusammenfassung** | Ein strukturiertes Briefing der ausgewählten Quellen | Generierungsmodell |
| **Karteikarten** | Ein interaktives Deck, eine Karte nach der anderen | Generierungsmodell |
| **Quiz** | Multiple-Choice-Fragen mit Antworten | Generierungsmodell |
| **Mindmap** | Eine Markmap zum Zoomen und Einklappen | Generierungsmodell |
| **Folien** | Eine bearbeitbare `.pptx`, kein Bild einer Präsentation | Generierungsmodell |
| **Dokument** | Ein bearbeitbarer `.docx`-Bericht | Generierungsmodell |
| **Tabellenkalkulation** | Eine `.xlsx` mit den Tabellen aus den Quellen | Generierungsmodell |
| **Webseite** | Eine eigenständige HTML-Seite | Generierungsmodell |
| **PDF** | Ein gesetztes PDF | Generierungsmodell |
| **Podcast** | Ein Zwiegespräch als Audio, offline gesprochen von Kokoro-82M | Generierungsmodell + mitgelieferte Stimme |
| **Bild** | Eine Illustration zum Material | Bildmodell + Generierungsmodell |
| **Infografik** | Eine visuelle Zusammenfassung auf einem Panel | Bildmodell + Generierungsmodell |
Manche Aufträge brauchen mehr als ein Format. Ein Lernleitfaden ist Zusammenfassung, Karteikarten und Quiz über denselben Quellensatz, und ein Kunden-Briefing ist meist die Präsentation, aus der du vorträgst, plus die Zusammenfassung, die du danach schickst. Video-Überblicke gibt es noch nicht.
## Alles bleibt auf deinem Rechner
Leute richten das auf Fallakten, Arbeitsunterlagen von Mandanten, Interview-Transkripte, interne Spezifikationen, unveröffentlichte Forschung und die Mitschriften eines ganzen Semesters. Du kannst über all das Fragen stellen, und jede Antwort nennt die Quelle, aus der sie kommt. Die App lädt davon nichts hoch.
- **Der Index ist lokal.** Parsen, Zerteilen und Embeddings laufen auf deinem Computer, in SQLite unter `~/.surfsense`. SurfSense behält keine Kopie und kein Protokoll dessen, was du gefragt hast.
- **Jede Rolle kann lokal laufen.** Der Dokumenten-Parser, das Retrieval-Modell und die Podcast-Stimme stecken im Installationsprogramm. Chat und Bilderzeugung kommen als lokale Server, deren Gewichte du einmal herunterlädst. Text, Audio und Bilder gehen also ohne Konto und ohne API-Schlüssel. Wir prüfen das, indem wir ein PDF bei abgeschaltetem Netzwerk einlesen.
- **Ausgehende Verbindungen sind standardmäßig aus.** Ein Ausgangspanel listet jedes Ziel, das die App erreichen kann, und du schaltest die frei, die du willst.
- **Keine Telemetrie, keine Absturzberichte.** Nichts meldet sich nach Hause, also gibt es auch keinen Schalter, den du erst suchen müsstest.
SurfSense kann dir nicht sagen, ob das eine bestimmte Vorschrift erfüllt. Das hängt von deinen eigenen Kontrollen und deiner Aufsicht ab. Die App kann dir nur sagen, auf welchem Rechner deine Dokumente liegen.
## So vergleicht sich SurfSense
Drei Arten von Produkten heißen „das lokale NotebookLM“, und sie beantworten verschiedene Fragen. Keines davon ist ein schlechtes Werkzeug. Du behältst am Ende nur unterschiedliche Dinge.
**Gegenüber Jan, AnythingLLM, Open WebUI, LM Studio.** Die führen ein Modell lokal aus und geben dir einen Ort, an dem du damit reden kannst. SurfSense beantwortet die nächste Frage: Wie kommt ein fertiges Dokument dabei heraus? Du kannst sie zusammen nutzen, indem du SurfSense auf einen beliebigen OpenAI-kompatiblen Endpunkt richtest, auch auf einen von ihnen.
**Gegenüber RemNote, Quizlet, NoteGPT, StudyFetch, Gamma.** Die erzeugen Ergebnisse, und manche sehen besser aus als unsere. Der Preis ist, wohin dein Material geht: Du lädst es hoch, zahlst monatlich, und deine Dateien liegen im Konto von jemand anderem.
**Gegenüber Google NotebookLM.** Es liefert schon Karteikarten, Quizze, Mindmaps und Audio-Überblicke, also entsteht auf beiden Seiten weitgehend dasselbe. Der Unterschied ist, wessen Rechner die Arbeit macht und welches Modell du darauf richten kannst.
| | Google NotebookLM | SurfSense |
|---|---|---|
| Läuft offline / netzgetrennt | Nein | **Ja** |
| Deine Dokumente verlassen deinen Rechner | Ja | **Nein** |
| Konto nötig | Google-Konto | **Keins** |
| Open Source | Nein | **Apache-2.0** |
| Preis | Kostenlose Stufe; Pro 19,99 $/Monat; Ultra 249,99 $/Monat | **Die App ist kostenlos** |
| Modelle | Nur Gemini | Jede OpenAI-kompatible API, oder ein lokales Modell |
| Quellenlimits | 50 bis 600 Quellen, je 500.000 Wörter | Was auf deine Festplatte passt |
| Audio- und Video-Überblicke | Ja, und besser | Audio ja, offline; Video noch nicht |
NotebookLM gewinnt bei der Audioqualität und hat Video. Wenn dir reicht, dass deine Quellen auf Googles Servern liegen, nimm es. Wenn nicht, ist das hier dieselbe Art Werkzeug, ohne den Upload.
## Schnellstart
Du brauchst kein Docker, kein Terminal, keine GPU und keine Compose-Datei.
1. **Lade das Installationsprogramm** aus der Tabelle oben. Es ist signiert, dein Betriebssystem stellt sich also nicht quer.
2. **Wähl ein Modell.** Lass die App ein lokales holen (Qwen3 in sechs Größen, ab 0,5 GB) oder füge Basis-URL und Schlüssel einer beliebigen OpenAI-kompatiblen API ein. Die Auswahl prüft, ob dein Rechner ein Modell ausführen kann, bevor sie es anbietet. Jeder Schlüssel, den du angibst, wird verschlüsselt gespeichert, das Geheimnis liegt im Schlüsselbund deines Betriebssystems.
3. **Wirf Dokumente hinein.** Die App liest PDFs, Office-Dateien und Bilder auf deinem Rechner.
4. **Stell Fragen.** Jede Antwort nennt die Quelle, aus der sie kommt.
5. **Öffne Studio,** wähl ein Format, nimm die Datei mit.
Der Download ist der langsame Teil, weil das Installationsprogramm Parser, Retrieval-Modell, Podcast-Stimme und die lokalen Modellserver mitbringt. Die App funktioniert deshalb auch ohne Netz.
## Dokumentation und Community
Die App und ihre Updates sind kostenlos. Eine Lizenz fügt Plugins und bevorzugten Support hinzu und sperrt sonst nichts. Eine abgelaufene Lizenz lässt dir die App und jedes künftige Update. Siehe [Preise](https://www.surfsense.com/pricing).
Der Docker-Stack in diesem Repo (`surfsense_backend`, `surfsense_web`, Compose-Dateien) bleibt Open Source und installierbar und wird **von der Community getragen: kein SLA und kein gehosteter Dienst dahinter.** Die Desktop-App ist der unterstützte Weg für neue Nutzer.
- [Dokumentation](https://www.surfsense.com/docs) zu Installation, Modellen, Studio-Formaten und Self-Hosting
- [Import aus der gehosteten App](https://www.surfsense.com/sunset)
- [MCP-Server](./surfsense_mcp) für die gehostete Scraper-API
- [Discord](https://discord.gg/ejRNvftDp9) für Hilfe und Ideen, [Discussions](https://github.com/MODSetter/SurfSense/discussions) für die Richtung, [Issues](https://github.com/MODSetter/SurfSense/issues) für nachvollziehbare Fehler
- **Gib dem Repo einen Stern,** wenn du verfolgen willst, wohin das geht
## Mitwirken
Pull Requests sind willkommen, und [CONTRIBUTING.md](CONTRIBUTING.md) geht den ganzen Ablauf durch. Kurz gesagt:
- **Such dir etwas zum Bearbeiten:** ein Issue mit dem Label [`good first issue`](https://github.com/MODSetter/SurfSense/labels/good%20first%20issue) oder [`help wanted`](https://github.com/MODSetter/SurfSense/labels/help%20wanted), oder eine Zeile aus der Liste Known gaps (bekannte Lücken) am Ende jedes Dokuments in [`docs/architecture/`](docs/architecture/overview.md).
- **Lies zuerst, wie es funktioniert:** [`docs/`](docs/README.md) erklärt jedes Feature und warum es so gebaut ist, und [`docs/ROADMAP.md`](docs/ROADMAP.md) zeigt, woran die Maintainer arbeiten.
- **Öffne einen PR gegen `dev`.** Fehlerbehebungen und Doku brauchen vorher keine Diskussion. Ein neues Feature beginnt mit einem kurzen Designvorschlag. Die Desktop-App liegt in [`surfsense_local/`](./surfsense_local), und deren README beschreibt die Entwicklungsschleife.
Danke an alle unsere Surfers:
<p align="center">
<a href="https://github.com/MODSetter/SurfSense/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MODSetter/SurfSense" alt="SurfSense-Mitwirkende" />
</a>
</p>
## Sterneverlauf
<p align="center">
<a href="https://www.star-history.com/#MODSetter/SurfSense&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
</picture>
</a>
</p>
## Lizenz
Apache-2.0. Siehe [LICENSE](LICENSE).

2
README.es.md
View file

@ -36,7 +36,7 @@
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | Español | <a href="README.pt-BR.md">Português</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.zh-CN.md">简体中文</a>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | Español | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>

171
README.fr.md Normal file
View file

@ -0,0 +1,171 @@
<!--
L'encadré de fermeture est daté. Supprimez-le le 18 octobre 2026, à la fin
de la fenêtre d'export, ainsi que le lien « Importer depuis l'application
hébergée » plus bas. Ce fichier suit README.md section par section.
Justification de cette page : plans/community-local/seo/06-repo-readme.md
-->
<div align="center">
[![Stars](https://img.shields.io/github/stars/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/stargazers)
[![Forks](https://img.shields.io/github/forks/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/network/members)
[![Latest release](https://img.shields.io/github/v/release/MODSetter/SurfSense?sort=semver)](https://github.com/MODSetter/SurfSense/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Discord](https://img.shields.io/discord/1359368468260192417?label=Discord)](https://discord.gg/ejRNvftDp9)
<a href="https://www.surfsense.com/"><img width="128" height="128" alt="SurfSense, l'alternative open source à NotebookLM, isolée du réseau" src="surfsense_web/public/homepage/icon.png" /></a>
<h1>SurfSense</h1>
<p>
<b>L'alternative open source à NotebookLM, isolée du réseau.</b>
<br />
Transformez les documents que vous ne pouvez pas téléverser en synthèses, présentations, rapports, guides d'étude et podcasts, entièrement sur votre propre machine.
</p>
<p>
<a href="https://www.surfsense.com/downloads"><b>Télécharger</b></a> ·
<a href="https://www.surfsense.com/docs">Documentation</a> ·
<a href="#ce-que-produit-surfsense">Ce qu'il produit</a> ·
<a href="#comment-surfsense-se-compare">Comparaison</a> ·
<a href="https://www.surfsense.com/pricing">Tarifs</a> ·
<a href="https://discord.gg/ejRNvftDp9">Discord</a>
</p>
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | Français | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>
<p align="center">
<img src="surfsense_web/public/homepage/offline-studio.png" alt="L'application de bureau SurfSense avec Studio ouvert et Qwen sélectionné, qui transforme des sources locales en livrables" />
</p>
SurfSense est une application de bureau gratuite et open source pour les documents que vous avez déjà. Déposez-les, posez des questions et obtenez des réponses qui citent leur source, puis transformez les mêmes documents en synthèse, présentation, rapport, guide d'étude ou podcast. Tout tourne sur votre propre machine : l'index est sur votre disque, vous choisissez le modèle, et l'application ne téléverse rien. Il n'y a pas de compte à créer.
**Pour commencer.** Téléchargez l'installateur pour votre machine, puis apportez votre propre clé de modèle ou laissez l'application récupérer un modèle local pour vous.
| Plateforme | Téléchargement |
|---|---|
| **Windows** x64 | [SurfSense-Setup.exe](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-Setup.exe) |
| **macOS** Apple Silicon | [SurfSense-arm64.dmg](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-arm64.dmg) |
| **Linux** x64 (AppImage) | [SurfSense.AppImage](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.AppImage) |
| **Linux** x64 (deb) | [SurfSense.deb](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.deb) |
Chaque lien pointe en permanence vers la dernière version. Vous pouvez aussi choisir sur [surfsense.com/downloads](https://www.surfsense.com/downloads) ou parcourir [toutes les versions](https://github.com/MODSetter/SurfSense/releases). L'AppImage se met à jour tout seul ; le deb, non.
> [!NOTE]
> **Vous utilisiez l'application web hébergée ?** Elle va être retirée. Ouvrez-la une fois pour exporter vos espaces de travail, puis importez le paquet dans l'application de bureau : documents, dossiers, titres et fils de discussion suivent. La fenêtre d'export se ferme le 18 octobre 2026. Détails sur [la page de fermeture](https://www.surfsense.com/sunset).
## Ce que produit SurfSense
Choisissez quelques documents et un format. L'application le rédige à partir des sources que vous avez choisies, sur votre machine.
| Format | Ce que vous obtenez | Il faut |
|---|---|---|
| **Synthèse** | Un brief structuré des sources sélectionnées | modèle de génération |
| **Cartes mémoire** | Un paquet interactif, une carte à la fois | modèle de génération |
| **Quiz** | Des questions à choix multiples avec les réponses | modèle de génération |
| **Carte mentale** | Une Markmap zoomable, aux nœuds repliables | modèle de génération |
| **Diapositives** | Un `.pptx` modifiable, pas une image de présentation | modèle de génération |
| **Document** | Un rapport `.docx` modifiable | modèle de génération |
| **Tableur** | Un `.xlsx` des tableaux extraits des sources | modèle de génération |
| **Page web** | Une page HTML autonome | modèle de génération |
| **PDF** | Un PDF mis en page | modèle de génération |
| **Podcast** | Une conversation audio à deux voix, lue hors ligne par Kokoro-82M | modèle de génération + voix fournie |
| **Image** | Une illustration pour le contenu | modèle d'image + modèle de génération |
| **Infographie** | Un résumé visuel sur un seul panneau | modèle d'image + modèle de génération |
Certains travaux en demandent plusieurs. Un guide d'étude, c'est une synthèse, un paquet de cartes et un quiz sur le même ensemble de sources, et un brief client est en général la présentation que vous projetez plus la synthèse que vous envoyez ensuite. Les aperçus vidéo ne sont pas encore là.
## Tout reste sur votre machine
On s'en sert pour des dossiers d'affaires, des documents de travail clients, des transcriptions d'entretiens, des spécifications internes, de la recherche non publiée et les notes d'un semestre entier. Vous pouvez interroger l'ensemble, et chaque réponse cite la source dont elle vient. L'application n'en téléverse rien.
- **L'index est local.** L'analyse, le découpage et les embeddings se font sur votre ordinateur, dans SQLite sous `~/.surfsense`. SurfSense n'en garde aucune copie et aucun journal de ce que vous avez demandé.
- **Chaque rôle peut tourner en local.** L'analyseur de documents, le modèle de recherche et la voix du podcast sont dans l'installateur. Le chat et la génération d'images arrivent comme des serveurs locaux dont vous téléchargez les poids une fois, donc vous produisez du texte, de l'audio et des images sans compte ni clé d'API. Nous le vérifions en ingérant un PDF avec le réseau coupé.
- **Les connexions sortantes sont coupées par défaut.** Un panneau de sorties liste chaque destination que l'application peut joindre, et vous activez celles que vous voulez.
- **Pas de télémétrie, pas de rapports de plantage.** Rien ne rappelle la maison, donc il n'y a pas d'option de refus à chercher.
SurfSense ne peut pas vous dire si cela satisfait une réglementation particulière. Cela dépend de vos propres contrôles et de votre régulateur. L'application peut seulement vous dire sur quelle machine se trouvent vos documents.
## Comment SurfSense se compare
Trois sortes de produits sont appelées « le NotebookLM local », et elles répondent à des questions différentes. Aucun n'est un mauvais outil. Ils vous laissent simplement avec des choses différentes.
**Face à Jan, AnythingLLM, Open WebUI, LM Studio.** Ils font tourner un modèle en local et vous donnent un endroit pour lui parler. SurfSense répond à la question suivante : comment en sortir un document fini ? Vous pouvez les combiner en pointant SurfSense vers n'importe quel endpoint compatible OpenAI, y compris l'un des leurs.
**Face à RemNote, Quizlet, NoteGPT, StudyFetch, Gamma.** Eux produisent bien des livrables, et certains sont plus beaux que les nôtres. Le compromis est l'endroit où va votre matériel : vous le téléversez, vous payez chaque mois, et vos fichiers vivent dans le compte de quelqu'un d'autre.
**Face à Google NotebookLM.** Il propose déjà cartes mémoire, quiz, cartes mentales et aperçus audio, donc les deux produisent à peu près les mêmes choses. La différence est la machine qui fait le travail, et le modèle que vous pouvez lui donner.
| | Google NotebookLM | SurfSense |
|---|---|---|
| Fonctionne hors ligne / isolé du réseau | Non | **Oui** |
| Vos documents quittent votre machine | Oui | **Non** |
| Compte requis | Compte Google | **Aucun** |
| Open source | Non | **Apache-2.0** |
| Prix | Offre gratuite ; Pro 19,99 $/mois ; Ultra 249,99 $/mois | **L'application est gratuite** |
| Modèles | Gemini seulement | Toute API compatible OpenAI, ou un modèle local |
| Limites de sources | 50 à 600 sources, 500 000 mots chacune | Ce que votre disque peut contenir |
| Aperçus audio et vidéo | Oui, et meilleurs | Audio oui, hors ligne ; vidéo pas encore |
NotebookLM gagne sur la qualité audio, et il a la vidéo. Si vos sources sur les serveurs de Google vous conviennent, utilisez-le. Sinon, voici le même genre d'outil, sans le téléversement.
## Démarrage rapide
Vous n'avez pas besoin de Docker, d'un terminal, d'un GPU ni d'un fichier compose.
1. **Téléchargez l'installateur** dans le tableau ci-dessus. Il est signé, votre système ne vous opposera donc pas de résistance.
2. **Choisissez un modèle.** Laissez l'application en récupérer un local (Qwen3 en six tailles, à partir de 0,5 GB) ou collez l'URL de base et la clé de n'importe quelle API compatible OpenAI. Le sélecteur vérifie que votre machine peut faire tourner un modèle avant de le proposer, et toute clé que vous lui donnez est stockée chiffrée, le secret dans le trousseau de votre système.
3. **Déposez des documents.** L'application analyse les PDF, les fichiers Office et les images sur votre machine.
4. **Posez des questions.** Chaque réponse cite la source dont elle vient.
5. **Ouvrez Studio,** choisissez un format, récupérez le fichier.
Le téléchargement est la partie lente, parce que l'installateur embarque l'analyseur, le modèle de recherche, la voix du podcast et les serveurs de modèles locaux, pour que l'application fonctionne réseau coupé.
## Documentation et communauté
L'application et ses mises à jour sont gratuites. Une licence ajoute des plugins et un support prioritaire, et ne verrouille rien d'autre : une licence expirée vous laisse l'application et chaque mise à jour future. Voir les [tarifs](https://www.surfsense.com/pricing).
La pile Docker de ce dépôt (`surfsense_backend`, `surfsense_web`, fichiers compose) reste open source et installable, et elle est **soutenue par la communauté : pas de SLA et aucun service hébergé derrière.** L'application de bureau est le chemin pris en charge pour les nouveaux utilisateurs.
- [Documentation](https://www.surfsense.com/docs) pour l'installation, les modèles, les formats Studio et l'auto-hébergement
- [Importer depuis l'application hébergée](https://www.surfsense.com/sunset)
- [Serveur MCP](./surfsense_mcp) pour l'API de scraping hébergée
- [Discord](https://discord.gg/ejRNvftDp9) pour l'aide et les idées, [Discussions](https://github.com/MODSetter/SurfSense/discussions) pour la direction, [Issues](https://github.com/MODSetter/SurfSense/issues) pour les bugs reproductibles
- **Mettez une étoile au dépôt** si vous voulez suivre la suite
## Contribuer
Les pull requests sont les bienvenues, et [CONTRIBUTING.md](CONTRIBUTING.md) décrit tout le parcours. En bref :
- **Trouvez quelque chose à faire :** un ticket étiqueté [`good first issue`](https://github.com/MODSetter/SurfSense/labels/good%20first%20issue) ou [`help wanted`](https://github.com/MODSetter/SurfSense/labels/help%20wanted), ou une ligne de la liste Known gaps (lacunes connues) à la fin de chaque document dans [`docs/architecture/`](docs/architecture/overview.md).
- **Lisez d'abord comment cela fonctionne :** [`docs/`](docs/README.md) explique chaque fonctionnalité et pourquoi elle est construite ainsi, et [`docs/ROADMAP.md`](docs/ROADMAP.md) montre ce sur quoi travaillent les mainteneurs.
- **Ouvrez une PR contre `dev`.** Les corrections de bugs et la documentation n'ont pas besoin d'une discussion préalable ; une nouvelle fonctionnalité commence par une courte proposition de conception. L'application de bureau vit dans [`surfsense_local/`](./surfsense_local), et son README décrit la boucle de développement.
Merci à tous nos Surfers :
<p align="center">
<a href="https://github.com/MODSetter/SurfSense/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MODSetter/SurfSense" alt="Contributeurs de SurfSense" />
</a>
</p>
## Historique des étoiles
<p align="center">
<a href="https://www.star-history.com/#MODSetter/SurfSense&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
</picture>
</a>
</p>
## Licence
Apache-2.0. Voir [LICENSE](LICENSE).

2
README.hi.md
View file

@ -35,7 +35,7 @@
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.es.md">Español</a> | <a href="README.pt-BR.md">Português</a> | हिन्दी | <a href="README.zh-CN.md">简体中文</a>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | हिन्दी | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>

171
README.ja.md Normal file
View file

@ -0,0 +1,171 @@
<!--
提供終了の注記には期限がある。書き出し期間が閉じる 2026 年 10 月 18 日に、
この注記と、下にある「ホスト版アプリから読み込む」リンクを削除する。
このファイルは README.md と節ごとに対応する。
このページの根拠: plans/community-local/seo/06-repo-readme.md
-->
<div align="center">
[![Stars](https://img.shields.io/github/stars/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/stargazers)
[![Forks](https://img.shields.io/github/forks/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/network/members)
[![Latest release](https://img.shields.io/github/v/release/MODSetter/SurfSense?sort=semver)](https://github.com/MODSetter/SurfSense/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Discord](https://img.shields.io/discord/1359368468260192417?label=Discord)](https://discord.gg/ejRNvftDp9)
<a href="https://www.surfsense.com/"><img width="128" height="128" alt="SurfSense。ネットワークから切り離して使える、オープンソースの NotebookLM 代替" src="surfsense_web/public/homepage/icon.png" /></a>
<h1>SurfSense</h1>
<p>
<b>ネットワークから切り離して使える、オープンソースの NotebookLM 代替。</b>
<br />
アップロードできない文書を、ブリーフィング、スライド、レポート、学習ガイド、ポッドキャストに。すべて自分のマシン上で。
</p>
<p>
<a href="https://www.surfsense.com/downloads"><b>ダウンロード</b></a> ·
<a href="https://www.surfsense.com/docs">ドキュメント</a> ·
<a href="#surfsenseで作れるもの">作れるもの</a> ·
<a href="#surfsenseの比較">比較</a> ·
<a href="https://www.surfsense.com/pricing">料金</a> ·
<a href="https://discord.gg/ejRNvftDp9">Discord</a>
</p>
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | 日本語 | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>
<p align="center">
<img src="surfsense_web/public/homepage/offline-studio.png" alt="Studio を開き Qwen を選んだ SurfSense デスクトップアプリ。手元の資料から成果物を作っている" />
</p>
SurfSense は、すでに持っている文書のための、無料のオープンソース・デスクトップアプリです。ドロップして質問すると、出典を付けた答えが返ります。同じ文書から、ブリーフィング、スライド、レポート、学習ガイド、ポッドキャストも作れます。処理はすべて自分のマシンで行われます。索引はディスク上にあり、モデルは自分で選び、アプリは何もアップロードしません。アカウントも要りません。
**はじめに。**自分のマシン用のインストーラーを入手し、手元のモデルキーを入れるか、アプリにローカルモデルを取ってきてもらいます。
| プラットフォーム | ダウンロード |
|---|---|
| **Windows** x64 | [SurfSense-Setup.exe](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-Setup.exe) |
| **macOS** Apple Silicon | [SurfSense-arm64.dmg](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-arm64.dmg) |
| **Linux** x64 (AppImage) | [SurfSense.AppImage](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.AppImage) |
| **Linux** x64 (deb) | [SurfSense.deb](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.deb) |
どのリンクも、常に最新リリースを指します。[surfsense.com/downloads](https://www.surfsense.com/downloads) から選ぶことも、[すべてのリリース](https://github.com/MODSetter/SurfSense/releases)を見ることもできます。AppImage は自動更新します。deb はしません。
> [!NOTE]
> **ホスト版の Web アプリを使っていましたか？** 提供を終了します。一度開いてワークスペースを書き出し、その束をデスクトップアプリに読み込んでください。文書、フォルダ、タイトル、チャットのスレッドがまとめて移ります。書き出し期間は 2026 年 10 月 18 日に閉じます。詳細は[提供終了のページ](https://www.surfsense.com/sunset)にあります。
## SurfSenseで作れるもの
文書をいくつか選び、形式を選びます。アプリは、選んだ資料から、自分のマシン上でそれを書きます。
| 形式 | 得られるもの | 必要なもの |
|---|---|---|
| **要約** | 選んだ資料の構造化されたブリーフ | 生成モデル |
| **フラッシュカード** | 1 枚ずつめくる対話式のデッキ | 生成モデル |
| **クイズ** | 解答付きの選択式問題 | 生成モデル |
| **マインドマップ** | 拡大でき、折りたためる Markmap | 生成モデル |
| **スライド** | 編集できる `.pptx`。デッキの画像ではない | 生成モデル |
| **文書** | 編集できる `.docx` のレポート | 生成モデル |
| **スプレッドシート** | 資料から取り出した表の `.xlsx` | 生成モデル |
| **Web ページ** | 単体で完結する HTML ページ | 生成モデル |
| **PDF** | 組版された PDF | 生成モデル |
| **ポッドキャスト** | 二者の音声対話。Kokoro-82M がオフラインで読み上げる | 生成モデル + 同梱の音声 |
| **画像** | 資料のための図版 | 画像モデル + 生成モデル |
| **インフォグラフィック** | 1 枚の視覚的な要約 | 画像モデル + 生成モデル |
仕事によっては、形式が一つでは足りません。学習ガイドは、同じ資料に対する要約、フラッシュカード、クイズです。顧客向けブリーフィングは、たいてい、発表に使うデッキと、そのあと送る要約の組です。動画の概要はまだありません。
## すべては自分のマシンに残る
事件記録、顧客の作業文書、インタビューの書き起こし、社内仕様、未発表の研究、学期分の講義ノート。そうした資料に向けて使われています。全体に質問でき、どの答えも出自の資料を示します。アプリはそのどれもアップロードしません。
- **索引はローカルです。** 解析、分割、埋め込みは自分のコンピュータ上で行われ、`~/.surfsense` 配下の SQLite に入ります。SurfSense はその複製を持たず、何を質問したかの記録も残しません。
- **どの役割もローカルで動かせます。** 文書パーサー、検索モデル、ポッドキャストの音声はインストーラーに入っています。チャットと画像生成はローカルサーバーとして入り、重みは一度ダウンロードすれば足ります。アカウントも API キーもなく、文章、音声、画像を作れます。確認方法は、ネットワークを切った状態で PDF を取り込むことです。
- **外向きの接続は、初期状態ではオフです。** 通信先パネルが、アプリが到達できる宛先をすべて列挙します。使うものだけをオンにします。
- **テレメトリも、クラッシュ報告もありません。** 何も外部に送信しないので、オプトアウトを探す必要もありません。
これが特定の規制を満たすかどうかは、SurfSense からは答えられません。それは自分の管理策と、所管の規制当局によります。アプリが言えるのは、文書がどのマシンにあるかだけです。
## SurfSenseの比較
「ローカル版 NotebookLM」と呼ばれる製品は三種類あり、答えている問いが違います。どれも悪い道具ではありません。手元に残るものが違うだけです。
**Jan、AnythingLLM、Open WebUI、LM Studio と比べて。** これらはモデルをローカルで動かし、それと話す場所をくれます。SurfSense が答えるのは、その次の問いです。そこから完成した文書をどう取り出すか。併用もできます。SurfSense を、OpenAI 互換の任意のエンドポイント（それらの製品が提供するものを含む）に向ければ足ります。
**RemNote、Quizlet、NoteGPT、StudyFetch、Gamma と比べて。** これらは成果物を作り、見た目がこちらのものより良いものもあります。引き換えに、資料の置き場所が変わります。アップロードし、月額を払い、ファイルは他人のアカウントに置かれます。
**Google NotebookLM と比べて。** あちらにはすでにフラッシュカード、クイズ、マインドマップ、音声概要があります。作れるものは、おおむね同じです。違うのは、作業をするマシンが誰のものかと、どのモデルを向けられるかです。
| | Google NotebookLM | SurfSense |
|---|---|---|
| オフライン / ネットワーク分離で動く | いいえ | **はい** |
| 文書が自分のマシンの外に出る | 出る | **出ない** |
| アカウント | Google アカウントが必要 | **不要** |
| オープンソース | いいえ | **Apache-2.0** |
| 料金 | 無料枠。Pro は月額 $19.99。Ultra は月額 $249.99 | **アプリは無料** |
| モデル | Gemini のみ | OpenAI 互換の任意の API、またはローカルモデル |
| 資料の上限 | 50 から 600 件、各 50 万語 | ディスクに入るだけ |
| 音声と動画の概要 | あり。品質は上 | 音声はあり、オフライン。動画はまだない |
音声の品質では NotebookLM が上で、動画もあります。資料が Google のサーバーに置かれてよいなら、あちらを使ってください。そうでないなら、こちらはアップロードのない、同じ種類の道具です。
## クイックスタート
Docker も、ターミナルも、GPU も、compose ファイルも要りません。
1. **インストーラーを入手する。** 上の表から。署名されているので、OS は邪魔しません。
2. **モデルを選ぶ。** ローカルモデルをアプリに取ってきてもらう（Qwen3 は 6 サイズ、最小 0.5 GB）か、OpenAI 互換 API のベース URL とキーを貼ります。選択画面は、マシンで動かせることを確認してからモデルを出します。渡したキーは暗号化して保存され、秘密は OS のキーチェーンに入ります。
3. **文書を入れる。** PDF、Office ファイル、画像は、自分のマシン上で解析されます。
4. **質問する。** どの答えも、出自の資料を示します。
5. **Studio を開き、**形式を選び、ファイルを受け取る。
遅いのはダウンロードです。インストーラーがパーサー、検索モデル、ポッドキャスト音声、ローカルモデルサーバーを同梱しているためです。だからネットワークを切ってもアプリは動きます。
## ドキュメントとコミュニティ
アプリとその更新は無料です。ライセンスが足すのはプラグインと優先サポートだけで、それ以外は何も止めません。期限が切れても、アプリと今後の更新はそのまま残ります。[料金](https://www.surfsense.com/pricing)を参照してください。
このリポジトリの Docker スタック（`surfsense_backend`、`surfsense_web`、compose ファイル）はオープンソースのままインストールでき、**コミュニティによるサポートです。SLA はなく、背後にホスト型サービスもありません。** 新規の利用者にとって、サポートされる経路はデスクトップアプリです。
- [ドキュメント](https://www.surfsense.com/docs)。インストール、モデル、Studio の形式、セルフホスト
- [ホスト版アプリから読み込む](https://www.surfsense.com/sunset)
- ホスト版スクレイパー API のための [MCP サーバー](./surfsense_mcp)
- 助けとアイデアは [Discord](https://discord.gg/ejRNvftDp9)、方向性は [Discussions](https://github.com/MODSetter/SurfSense/discussions)、再現できる不具合は [Issues](https://github.com/MODSetter/SurfSense/issues)
- この先を追うなら、**リポジトリにスターを付けてください**
## 開発に参加する
プルリクエストを歓迎します。流れの全体は [CONTRIBUTING.md](CONTRIBUTING.md) にあります。短く言うと次のとおりです。
- **取り組むものを見つける。** [`good first issue`](https://github.com/MODSetter/SurfSense/labels/good%20first%20issue) または [`help wanted`](https://github.com/MODSetter/SurfSense/labels/help%20wanted) のラベルが付いた issue、あるいは [`docs/architecture/`](docs/architecture/overview.md) の各文書末尾にある Known gaps（既知の欠け）の一行。
- **先に仕組みを読む。** [`docs/`](docs/README.md) が各機能と、なぜそう作られているかを説明し、[`docs/ROADMAP.md`](docs/ROADMAP.md) がメンテナーの作業中のものを示します。
- **`dev` に対して PR を開く。** 不具合修正とドキュメントは、事前の議論が要りません。新機能は短い設計提案から始めます。デスクトップアプリは [`surfsense_local/`](./surfsense_local) にあり、その README が開発の一周を説明します。
Surfers の皆さんに感謝します。
<p align="center">
<a href="https://github.com/MODSetter/SurfSense/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MODSetter/SurfSense" alt="SurfSense のコントリビューター" />
</a>
</p>
## スター履歴
<p align="center">
<a href="https://www.star-history.com/#MODSetter/SurfSense&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
</picture>
</a>
</p>
## ライセンス
Apache-2.0。 [LICENSE](LICENSE) を参照してください。

171
README.ko.md Normal file
View file

@ -0,0 +1,171 @@
<!--
서비스 종료 안내에는 기한이 있습니다. 내보내기 기간이 끝나는 2026년 10월 18일에
이 안내와, 아래의 "호스팅 앱에서 가져오기" 링크를 삭제하세요.
이 파일은 README.md와 절마다 대응합니다.
이 페이지의 근거: plans/community-local/seo/06-repo-readme.md
-->
<div align="center">
[![Stars](https://img.shields.io/github/stars/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/stargazers)
[![Forks](https://img.shields.io/github/forks/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/network/members)
[![Latest release](https://img.shields.io/github/v/release/MODSetter/SurfSense?sort=semver)](https://github.com/MODSetter/SurfSense/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Discord](https://img.shields.io/discord/1359368468260192417?label=Discord)](https://discord.gg/ejRNvftDp9)
<a href="https://www.surfsense.com/"><img width="128" height="128" alt="SurfSense, 네트워크와 분리해 쓰는 오픈소스 NotebookLM 대안" src="surfsense_web/public/homepage/icon.png" /></a>
<h1>SurfSense</h1>
<p>
<b>네트워크와 분리해 쓰는 오픈소스 NotebookLM 대안.</b>
<br />
업로드할 수 없는 문서를, 전부 내 컴퓨터에서 브리핑, 슬라이드, 보고서, 학습 가이드, 팟캐스트로 바꿉니다.
</p>
<p>
<a href="https://www.surfsense.com/downloads"><b>다운로드</b></a> ·
<a href="https://www.surfsense.com/docs">문서</a> ·
<a href="#surfsense가-만드는-것">만드는 것</a> ·
<a href="#surfsense-비교">비교</a> ·
<a href="https://www.surfsense.com/pricing">요금</a> ·
<a href="https://discord.gg/ejRNvftDp9">Discord</a>
</p>
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | 한국어 | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>
<p align="center">
<img src="surfsense_web/public/homepage/offline-studio.png" alt="Studio를 열고 Qwen을 선택한 SurfSense 데스크톱 앱. 로컬 자료를 결과물로 바꾸고 있다" />
</p>
SurfSense는 이미 가진 문서를 위한 무료 오픈소스 데스크톱 앱입니다. 끌어다 놓고 질문하면, 출처를 밝히는 답이 돌아옵니다. 같은 문서로 브리핑, 슬라이드, 보고서, 학습 가이드, 팟캐스트도 만듭니다. 전부 내 컴퓨터에서 돌아갑니다. 색인은 디스크에 있고, 모델은 내가 고르며, 앱은 아무것도 업로드하지 않습니다. 만들 계정도 없습니다.
**시작하기.** 내 컴퓨터용 설치 파일을 받은 다음, 가지고 있는 모델 키를 넣거나 앱이 로컬 모델을 받아 오게 합니다.
| 플랫폼 | 다운로드 |
|---|---|
| **Windows** x64 | [SurfSense-Setup.exe](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-Setup.exe) |
| **macOS** Apple Silicon | [SurfSense-arm64.dmg](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-arm64.dmg) |
| **Linux** x64 (AppImage) | [SurfSense.AppImage](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.AppImage) |
| **Linux** x64 (deb) | [SurfSense.deb](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.deb) |
모든 링크는 최신 릴리스를 가리키는 고정 주소입니다. [surfsense.com/downloads](https://www.surfsense.com/downloads)에서 고르거나 [모든 릴리스](https://github.com/MODSetter/SurfSense/releases)를 볼 수도 있습니다. AppImage는 자동으로 업데이트되고, deb는 그렇지 않습니다.
> [!NOTE]
> **호스팅 웹 앱을 쓰셨나요?** 서비스가 종료됩니다. 한 번 열어서 작업 공간을 내보낸 다음, 그 묶음을 데스크톱 앱으로 가져오세요. 문서, 폴더, 제목, 채팅 스레드가 함께 넘어옵니다. 내보내기 기간은 2026년 10월 18일에 닫힙니다. 자세한 내용은 [종료 안내 페이지](https://www.surfsense.com/sunset)에 있습니다.
## SurfSense가 만드는 것
문서 몇 개와 형식을 고릅니다. 앱은 고른 자료로, 내 컴퓨터에서 그것을 씁니다.
| 형식 | 받게 되는 것 | 필요한 것 |
|---|---|---|
| **요약** | 고른 자료의 구조화된 브리프 | 생성 모델 |
| **플래시카드** | 한 장씩 넘기는 대화형 덱 | 생성 모델 |
| **퀴즈** | 답이 있는 객관식 문제 | 생성 모델 |
| **마인드맵** | 확대하고 접을 수 있는 Markmap | 생성 모델 |
| **슬라이드** | 편집할 수 있는 `.pptx`. 덱을 찍은 그림이 아님 | 생성 모델 |
| **문서** | 편집할 수 있는 `.docx` 보고서 | 생성 모델 |
| **스프레드시트** | 자료에서 뽑은 표의 `.xlsx` | 생성 모델 |
| **웹 페이지** | 그 자체로 완결된 HTML 페이지 | 생성 모델 |
| **PDF** | 조판된 PDF | 생성 모델 |
| **팟캐스트** | 두 진행자의 음성 대화. Kokoro-82M이 오프라인으로 읽음 | 생성 모델 + 함께 제공되는 음성 |
| **이미지** | 자료를 위한 삽화 | 이미지 모델 + 생성 모델 |
| **인포그래픽** | 한 장으로 된 시각 요약 | 이미지 모델 + 생성 모델 |
어떤 일은 형식이 하나로는 부족합니다. 학습 가이드는 같은 자료에 대한 요약, 플래시카드, 퀴즈입니다. 고객 브리핑은 보통, 발표에 쓰는 덱과 그 뒤에 보내는 요약입니다. 영상 개요는 아직 없습니다.
## 모든 것은 내 컴퓨터에 남습니다
사건 기록, 고객 작업 문서, 인터뷰 녹취, 내부 사양, 미발표 연구, 한 학기 분의 강의 노트. 사람들이 이런 자료에 이 앱을 씁니다. 그 전부에 질문할 수 있고, 모든 답은 나온 자료를 밝힙니다. 앱은 그중 아무것도 업로드하지 않습니다.
- **색인은 로컬입니다.** 파싱, 청크 나누기, 임베딩은 내 컴퓨터에서 이루어지고, `~/.surfsense` 아래 SQLite에 들어갑니다. SurfSense는 사본을 두지 않고, 무엇을 물었는지도 기록하지 않습니다.
- **모든 역할이 로컬에서 돕니다.** 문서 파서, 검색 모델, 팟캐스트 음성은 설치 파일 안에 있습니다. 채팅과 이미지 생성은 로컬 서버로 들어오고, 가중치는 한 번 받으면 됩니다. 계정이나 API 키 없이 글, 오디오, 그림을 만들 수 있습니다. 확인 방법은 네트워크를 끈 채 PDF를 넣는 것입니다.
- **나가는 연결은 기본으로 꺼져 있습니다.** 외부 연결 패널이 앱이 닿을 수 있는 대상을 모두 나열하고, 원하는 것만 켭니다.
- **원격 측정 없음, 충돌 보고 없음.** 밖으로 나가는 것이 없으니, 찾을 옵트아웃도 없습니다.
SurfSense는 이것이 특정 규정을 만족하는지 알려 주지 못합니다. 그것은 자신의 통제와 규제 기관에 달렸습니다. 앱이 말해 줄 수 있는 것은, 문서가 어느 컴퓨터에 있는지뿐입니다.
## SurfSense 비교
"로컬 NotebookLM"이라 불리는 제품은 세 종류이고, 답하는 질문이 다릅니다. 어느 것도 나쁜 도구는 아닙니다. 마지막에 손에 남는 것이 다를 뿐입니다.
**Jan, AnythingLLM, Open WebUI, LM Studio와 비교하면.** 이들은 모델을 로컬에서 실행하고, 그와 이야기할 곳을 줍니다. SurfSense가 답하는 것은 그다음 질문입니다. 거기서 완성된 문서를 어떻게 꺼내는가. 함께 써도 됩니다. SurfSense를 OpenAI 호환 엔드포인트라면 어디든, 그들이 제공하는 것까지 포함해 가리키면 됩니다.
**RemNote, Quizlet, NoteGPT, StudyFetch, Gamma와 비교하면.** 이들은 결과물을 만들고, 우리 것보다 보기 좋은 것도 있습니다. 대가는 자료가 가는 곳입니다. 업로드하고, 매달 돈을 내고, 파일은 다른 사람의 계정에 있습니다.
**Google NotebookLM과 비교하면.** 그쪽에는 이미 플래시카드, 퀴즈, 마인드맵, 오디오 개요가 있어서, 둘 다 거의 같은 것을 만듭니다. 차이는 일을 하는 컴퓨터가 누구의 것인지, 그리고 어떤 모델을 붙일 수 있는지입니다.
| | Google NotebookLM | SurfSense |
|---|---|---|
| 오프라인 / 네트워크 분리로 동작 | 아니요 | **예** |
| 문서가 내 컴퓨터를 떠남 | 떠남 | **떠나지 않음** |
| 계정 | Google 계정 필요 | **없음** |
| 오픈소스 | 아니요 | **Apache-2.0** |
| 가격 | 무료 구간. Pro 월 $19.99. Ultra 월 $249.99 | **앱은 무료** |
| 모델 | Gemini만 | OpenAI 호환 API 전부, 또는 로컬 모델 |
| 자료 한도 | 자료 50개에서 600개, 각각 50만 단어 | 디스크에 들어가는 만큼 |
| 오디오와 영상 개요 | 둘 다 있고, 더 낫다 | 오디오는 있음, 오프라인. 영상은 아직 없음 |
오디오 품질은 NotebookLM이 앞서고, 영상도 있습니다. 자료가 Google 서버에 있어도 괜찮다면 그것을 쓰세요. 그렇지 않다면, 이쪽이 업로드 없는 같은 종류의 도구입니다.
## 빠른 시작
Docker도, 터미널도, GPU도, compose 파일도 필요 없습니다.
1. **설치 파일을 받습니다.** 위 표에 있습니다. 서명되어 있어서 운영체제가 막지 않습니다.
2. **모델을 고릅니다.** 로컬 모델을 앱이 받게 두거나(Qwen3, 여섯 가지 크기, 최소 0.5 GB), OpenAI 호환 API의 베이스 URL과 키를 붙입니다. 선택 화면은 내 컴퓨터가 모델을 돌릴 수 있는지 확인한 뒤에 보여 줍니다. 넣은 키는 암호화되어 저장되고, 비밀은 운영체제 키체인에 있습니다.
3. **문서를 넣습니다.** PDF, Office 파일, 이미지는 내 컴퓨터에서 파싱됩니다.
4. **질문합니다.** 모든 답이 나온 자료를 밝힙니다.
5. **Studio를 열고,** 형식을 고른 다음, 파일을 가져갑니다.
느린 부분은 다운로드입니다. 설치 파일에 파서, 검색 모델, 팟캐스트 음성, 로컬 모델 서버가 들어 있어서, 네트워크가 꺼져 있어도 앱이 동작합니다.
## 문서와 커뮤니티
앱과 그 업데이트는 무료입니다. 라이선스가 더하는 것은 플러그인과 우선 지원뿐이고, 그 밖에는 아무것도 잠그지 않습니다. 라이선스가 만료되어도 앱과 이후의 모든 업데이트는 그대로 남습니다. [요금](https://www.surfsense.com/pricing)을 보세요.
이 저장소의 Docker 스택(`surfsense_backend`, `surfsense_web`, compose 파일)은 계속 오픈소스이고 설치할 수 있으며, **커뮤니티가 지원합니다. SLA는 없고, 뒤에 호스팅 서비스도 없습니다.** 새 사용자에게 지원되는 경로는 데스크톱 앱입니다.
- 설치, 모델, Studio 형식, 자체 호스팅은 [문서](https://www.surfsense.com/docs)
- [호스팅 앱에서 가져오기](https://www.surfsense.com/sunset)
- 호스팅 스크레이퍼 API를 위한 [MCP 서버](./surfsense_mcp)
- 도움과 아이디어는 [Discord](https://discord.gg/ejRNvftDp9), 방향은 [Discussions](https://github.com/MODSetter/SurfSense/discussions), 재현되는 버그는 [Issues](https://github.com/MODSetter/SurfSense/issues)
- 이 다음을 따라가려면 **저장소에 스타를 누르세요**
## 기여
풀 리퀘스트를 환영하며, 전체 흐름은 [CONTRIBUTING.md](CONTRIBUTING.md)에 있습니다. 짧게 말하면 이렇습니다.
- **할 일을 찾습니다.** [`good first issue`](https://github.com/MODSetter/SurfSense/labels/good%20first%20issue) 또는 [`help wanted`](https://github.com/MODSetter/SurfSense/labels/help%20wanted) 라벨이 붙은 이슈, 또는 [`docs/architecture/`](docs/architecture/overview.md) 각 문서 끝의 Known gaps(알려진 빈틈) 목록의 한 줄.
- **먼저 어떻게 동작하는지 읽습니다.** [`docs/`](docs/README.md)가 각 기능과 왜 그렇게 만들어졌는지를 설명하고, [`docs/ROADMAP.md`](docs/ROADMAP.md)가 메인테이너가 작업 중인 것을 보여 줍니다.
- **`dev`에 PR을 엽니다.** 버그 수정과 문서는 사전 논의가 필요 없습니다. 새 기능은 짧은 설계 제안으로 시작합니다. 데스크톱 앱은 [`surfsense_local/`](./surfsense_local)에 있고, 그 README가 개발 순환을 설명합니다.
모든 Surfer에게 감사합니다.
<p align="center">
<a href="https://github.com/MODSetter/SurfSense/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MODSetter/SurfSense" alt="SurfSense 기여자" />
</a>
</p>
## 스타 기록
<p align="center">
<a href="https://www.star-history.com/#MODSetter/SurfSense&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
</picture>
</a>
</p>
## 라이선스
Apache-2.0. [LICENSE](LICENSE)를 보세요.

6
README.md
View file

@ -1,8 +1,8 @@
<!--
The sunset callout is time-boxed. Delete it on 18 October 2026 when the
export window closes, along with the "Importing from the hosted app" link
further down. Do the same in README.es.md, README.pt-BR.md, README.hi.md and
README.zh-CN.md, which track this file section for section.
further down. Do the same in every README.<locale>.md. Those files track
this one section for section.
Rationale for this page: plans/community-local/seo/06-repo-readme.md
-->
@ -36,7 +36,7 @@
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
English | <a href="README.es.md">Español</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.zh-CN.md">简体中文</a>
English | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>

2
README.pt-BR.md
View file

@ -36,7 +36,7 @@
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.es.md">Español</a> | Português | <a href="README.hi.md">हिन्दी</a> | <a href="README.zh-CN.md">简体中文</a>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | Português | <a href="README.ru.md">Русский</a> | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>

171
README.ru.md Normal file
View file

@ -0,0 +1,171 @@
<!--
Пометка о закрытии ограничена по времени. Удалите её 18 октября 2026 года,
когда закроется окно экспорта, вместе со ссылкой «Импорт из размещённого
приложения» ниже. Этот файл повторяет README.md раздел за разделом.
Обоснование страницы: plans/community-local/seo/06-repo-readme.md
-->
<div align="center">
[![Stars](https://img.shields.io/github/stars/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/stargazers)
[![Forks](https://img.shields.io/github/forks/MODSetter/SurfSense?style=social)](https://github.com/MODSetter/SurfSense/network/members)
[![Latest release](https://img.shields.io/github/v/release/MODSetter/SurfSense?sort=semver)](https://github.com/MODSetter/SurfSense/releases)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
[![Discord](https://img.shields.io/discord/1359368468260192417?label=Discord)](https://discord.gg/ejRNvftDp9)
<a href="https://www.surfsense.com/"><img width="128" height="128" alt="SurfSense, изолированная от сети альтернатива NotebookLM с открытым кодом" src="surfsense_web/public/homepage/icon.png" /></a>
<h1>SurfSense</h1>
<p>
<b>Изолированная от сети альтернатива NotebookLM с открытым кодом.</b>
<br />
Превратите документы, которые нельзя загрузить наружу, в брифинги, презентации, отчёты, учебные руководства и подкасты, целиком на своём компьютере.
</p>
<p>
<a href="https://www.surfsense.com/downloads"><b>Скачать</b></a> ·
<a href="https://www.surfsense.com/docs">Документация</a> ·
<a href="#что-делает-surfsense">Что делает</a> ·
<a href="#как-surfsense-сравнивается">Сравнение</a> ·
<a href="https://www.surfsense.com/pricing">Цены</a> ·
<a href="https://discord.gg/ejRNvftDp9">Discord</a>
</p>
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | Русский | <a href="README.zh-CN.md">简体中文</a>
</p>
</div>
<p align="center">
<img src="surfsense_web/public/homepage/offline-studio.png" alt="Настольное приложение SurfSense со Studio открытым и выбранным Qwen, превращающее локальные источники в результаты" />
</p>
SurfSense — бесплатное настольное приложение с открытым кодом для документов, которые уже есть. Перетащите их внутрь, задайте вопросы и получите ответы со ссылкой на источник, а затем превратите те же документы в брифинг, презентацию, отчёт, учебное руководство или подкаст. Всё это работает на вашем компьютере: индекс лежит на диске, модель выбираете вы, и приложение ничего не отправляет. Аккаунт создавать не нужно.
**С чего начать.** Скачайте установщик для своего компьютера, затем принесите свой ключ модели или пусть приложение само скачает локальную модель.
| Платформа | Скачать |
|---|---|
| **Windows** x64 | [SurfSense-Setup.exe](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-Setup.exe) |
| **macOS** Apple Silicon | [SurfSense-arm64.dmg](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense-arm64.dmg) |
| **Linux** x64 (AppImage) | [SurfSense.AppImage](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.AppImage) |
| **Linux** x64 (deb) | [SurfSense.deb](https://github.com/MODSetter/SurfSense/releases/latest/download/SurfSense.deb) |
Каждая ссылка всегда ведёт на самый новый выпуск. Можно также выбрать на [surfsense.com/downloads](https://www.surfsense.com/downloads) или просмотреть [все выпуски](https://github.com/MODSetter/SurfSense/releases). AppImage обновляется сам; deb нет.
> [!NOTE]
> **Пользовались размещённым веб-приложением?** Его выводят из работы. Откройте его один раз, экспортируйте рабочие пространства, затем импортируйте пакет в настольное приложение. Документы, папки, названия и ветки чатов переносятся все. Окно экспорта закрывается 18 октября 2026 года. Подробности на [странице закрытия](https://www.surfsense.com/sunset).
## Что делает SurfSense
Выберите несколько документов и формат. Приложение пишет результат из выбранных источников, на вашем компьютере.
| Формат | Что получается | Нужно |
|---|---|---|
| **Сводка** | Структурированный бриф выбранных источников | модель генерации |
| **Карточки** | Интерактивная колода, по одной карточке | модель генерации |
| **Тест** | Вопросы с вариантами ответа и сами ответы | модель генерации |
| **Ментальная карта** | Масштабируемая сворачиваемая Markmap | модель генерации |
| **Слайды** | Редактируемый `.pptx`, не картинка презентации | модель генерации |
| **Документ** | Редактируемый отчёт `.docx` | модель генерации |
| **Таблица** | `.xlsx` таблиц, извлечённых из источников | модель генерации |
| **Веб-страница** | Самодостаточная страница HTML | модель генерации |
| **PDF** | Свёрстанный PDF | модель генерации |
| **Подкаст** | Аудиоразговор двух ведущих, озвученный без сети моделью Kokoro-82M | модель генерации + голос в комплекте |
| **Изображение** | Иллюстрация к материалу | модель изображений + модель генерации |
| **Инфографика** | Наглядная сводка на одной панели | модель изображений + модель генерации |
Некоторым задачам нужно больше одного формата. Учебное руководство — это сводка, колода карточек и тест по тому же набору источников, а клиентский брифинг обычно состоит из презентации, с которой выступают, и сводки, которую отправляют после. Видеообзоры ещё не сделаны.
## Всё остаётся на вашем компьютере
Сюда направляют материалы дел, рабочие бумаги клиентов, расшифровки интервью, внутренние спецификации, неопубликованные исследования и конспекты лекций за целый семестр. Можно задавать вопросы по всему этому, и каждый ответ называет источник, из которого он взят. Приложение ничего из этого не загружает.
- **Индекс локальный.** Разбор, нарезка и эмбеддинги происходят на компьютере, в SQLite по пути `~/.surfsense`. SurfSense не хранит копию и не ведёт журнал того, что спрашивали.
- **Каждая роль может работать локально.** Разборщик документов, модель поиска и голос подкаста лежат внутри установщика. Чат и генерация изображений поставляются как локальные серверы, чьи веса скачиваются один раз, поэтому текст, звук и картинки получаются без аккаунта и без ключа API. Мы проверяем это, принимая PDF при отключённой сети.
- **Исходящие подключения выключены по умолчанию.** Панель исходящих адресов перечисляет каждое место, до которого приложение может достучаться, и включаются только нужные.
- **Никакой телеметрии и никаких отчётов о сбоях.** Ничто не связывается с разработчиком, поэтому нет переключателя, который пришлось бы искать.
SurfSense не скажет, удовлетворяет ли это конкретному регулированию. Это зависит от собственных мер контроля и от регулятора. Приложение может сказать только одно: на каком компьютере лежат документы.
## Как SurfSense сравнивается
Три вида продуктов называют «локальным NotebookLM», и они отвечают на разные вопросы. Ни один из них не плохой инструмент. На руках в итоге остаётся разное.
**В сравнении с Jan, AnythingLLM, Open WebUI, LM Studio.** Они запускают модель локально и дают место, где с ней можно говорить. SurfSense отвечает на следующий вопрос: как получить из этого готовый документ? Их можно использовать вместе, направив SurfSense на любую конечную точку, совместимую с OpenAI, в том числе на их собственную.
**В сравнении с RemNote, Quizlet, NoteGPT, StudyFetch, Gamma.** Они тоже делают готовые материалы, и некоторые выглядят лучше наших. Расплата в том, куда уходит материал: его загружают, платят каждый месяц, и файлы живут в чужом аккаунте.
**В сравнении с Google NotebookLM.** Там уже есть карточки, тесты, ментальные карты и аудиообзоры, так что оба делают по большей части одно и то же. Разница в том, чей компьютер делает работу и на какую модель можно его направить.
| | Google NotebookLM | SurfSense |
|---|---|---|
| Работает без сети / изолирован от сети | Нет | **Да** |
| Документы покидают компьютер | Да | **Нет** |
| Нужен аккаунт | Аккаунт Google | **Не нужен** |
| Открытый код | Нет | **Apache-2.0** |
| Цена | Бесплатный уровень; Pro $19.99 в месяц; Ultra $249.99 в месяц | **Приложение бесплатно** |
| Модели | Только Gemini | Любой совместимый с OpenAI API, или локальная модель |
| Лимиты источников | от 50 до 600 источников, по 500,000 слов | Сколько вмещает диск |
| Аудио- и видеообзоры | Да, и лучше | Аудио да, без сети; видео ещё нет |
NotebookLM выигрывает по качеству звука, и у него есть видео. Если устраивает, что источники лежат на серверах Google, пользуйтесь им. Если нет, здесь тот же род инструмента, без загрузки наружу.
## Быстрый старт
Не нужны Docker, терминал, GPU и compose-файл.
1. **Скачайте установщик** из таблицы выше. Он подписан, так что система не станет с ним воевать.
2. **Выберите модель.** Пусть приложение само скачает локальную (Qwen3 в шести размерах, от 0.5 GB) или вставьте базовый URL и ключ любого API, совместимого с OpenAI. Выбор проверяет, что компьютер потянет модель, прежде чем предлагать её, а любой ключ хранится зашифрованным, и секрет лежит в связке ключей ОС.
3. **Перетащите документы.** Приложение разбирает PDF, файлы Office и изображения на компьютере.
4. **Задавайте вопросы.** Каждый ответ называет источник, из которого он взят.
5. **Откройте Studio,** выберите формат, заберите файл.
Скачивание — медленная часть, потому что установщик несёт разборщик, модель поиска, голос подкаста и локальные серверы моделей, и поэтому приложение работает с выключенной сетью.
## Документация и сообщество
Приложение и его обновления бесплатны. Лицензия добавляет плагины и приоритетную поддержку и больше ничего не закрывает, поэтому истёкшая лицензия всё равно оставляет приложение и каждое будущее обновление. См. [цены](https://www.surfsense.com/pricing).
Стек Docker в этом репозитории (`surfsense_backend`, `surfsense_web`, compose-файлы) остаётся открытым и устанавливаемым и **держится на сообществе: без соглашения об уровне сервиса и без размещённой службы за ним.** Настольное приложение — поддерживаемый путь для новых пользователей.
- [Документация](https://www.surfsense.com/docs) по установке, моделям, форматам Studio и самостоятельному хостингу
- [Импорт из размещённого приложения](https://www.surfsense.com/sunset)
- [Сервер MCP](./surfsense_mcp) для размещённого API скрейпера
- [Discord](https://discord.gg/ejRNvftDp9) для помощи и идей, [Discussions](https://github.com/MODSetter/SurfSense/discussions) для направления, [Issues](https://github.com/MODSetter/SurfSense/issues) для воспроизводимых ошибок
- **Поставьте звезду репозиторию**, если хотите следить, куда это идёт
## Участие
Запросы на слияние приветствуются, и [CONTRIBUTING.md](CONTRIBUTING.md) проводит по всему пути. Коротко:
- **Найти, над чем работать:** задача с меткой [`good first issue`](https://github.com/MODSetter/SurfSense/labels/good%20first%20issue) или [`help wanted`](https://github.com/MODSetter/SurfSense/labels/help%20wanted), или строка из списка Known gaps (известные пробелы) в конце каждого документа в [`docs/architecture/`](docs/architecture/overview.md).
- **Сначала прочитайте, как это устроено:** [`docs/`](docs/README.md) объясняет каждую возможность и почему она сделана так, а [`docs/ROADMAP.md`](docs/ROADMAP.md) показывает, над чем работают сопровождающие.
- **Откройте запрос на слияние в `dev`.** Исправления ошибок и документация не требуют обсуждения заранее. Новая возможность начинается с короткого проектного предложения. Настольное приложение живёт в [`surfsense_local/`](./surfsense_local), и его README описывает цикл разработки.
Спасибо всем нашим Surfers:
<p align="center">
<a href="https://github.com/MODSetter/SurfSense/graphs/contributors">
<img src="https://contrib.rocks/image?repo=MODSetter/SurfSense" alt="SurfSense contributors" />
</a>
</p>
## История звёзд
<p align="center">
<a href="https://www.star-history.com/#MODSetter/SurfSense&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MODSetter/SurfSense&type=Date" />
</picture>
</a>
</p>
## Лицензия
Apache-2.0. См. [LICENSE](LICENSE).

2
README.zh-CN.md
View file

@ -35,7 +35,7 @@
<a href="https://trendshift.io/repositories/13606" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13606" alt="MODSetter/SurfSense | Trendshift" width="250" height="55" /></a>
<p>
<a href="README.md">English</a> | <a href="README.es.md">Español</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.hi.md">हिन्दी</a> | 简体中文
<a href="README.md">English</a> | <a href="README.ar.md">العربية</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.ru.md">Русский</a> | 简体中文
</p>
</div>