surf README

The project's README from github.com/deta/surf. As one markdown file: README.md.

splash

Website - Discord


Deta Surf: Your AI Notebook

Deta Surf is an AI notebook that brings all your files and the web directly into your stream of thought.

It’s meant for simultaneous research and thinking that minimizes the grunt work: manually searching, opening windows & tabs, scrolling, copying and pasting into a document editor.

Surf is primarily built in Svelte, TypeScript and Rust, runs on MacOS, Windows & Linux, stores data locally in open formats, and is open source.

split

Motivation

Most applications are focused on a single task, or a single media type: notes, websites, or PDFs. Real thinking requires juggling media across sources to make connections and synthesize ideas. We want to help people think better, across all their media.

Surf is built to be personal and open, in service of the user. This means local first data, open data formats, open source, and openness with respect to AI models. Read more.

Installation

Checkout the installation guide for detailed instructions.

For building from source and local development, see CONTRIBUTING.md.

TL;DR - Things to try

Features

Multi-Media Library & Notebooks

notebooks

Store almost any media in a private library on your computer, in an open and transparent format.

Surf's library is built on a local storage engine called SFFS (Surf Flat File System), which stores data in open and transparent formats.

Details on the library.

Smart Notes

smart-notes

Explore and think across your digital stuff without opening up a bunch of windows, clicking, scrolling and copying & pasting into your document (or chatbot).

Read more.

Tabs, Split View & Sidebar

split

Surf is built around tabs, split view and a sidebar for easy navigation.

Surflets (App Generation)

surflets

Surf can code interactive applets to help you visualize, understand or explore concepts or data that are aided with code.

Read more.

AI

models.png

Surf’s notes and Surflets are powered by large language models of your choice.

Read more.

Shortcuts

Find the most common shortcuts here.

Security

To report a security concern, please see https://github.com/deta/surf/security/policy

Contributing

See CONTRIBUTING.md for details on contributing to the project and an overview of the codebase.

Code of Conduct

See CODE_OF_CONDUCT.md for details on our code of conduct.

License

The source code for this project is licensed under the Apache 2.0 license, with the following exceptions:

  1. Our patch for the @ghostery/adblocker-electron package is licensed under the Mozilla Public License 2.0 (MPL-2.0), consistent with the upstream project's licensing.
  2. Select files may contain their own specific license headers that override the default license.

Unless otherwise specified in the file or directory, all code defaults to the Apache 2.0 license.

See LICENSE for more details about the Apache 2.0 license.

Note: The Deta name and logos are not covered by the Apache 2.0 license.

Acknowledgements

This project makes use of the following open source packages (not a comprehensive list):

surf (deta/surf)

Searching Database…

3.6K ·GitHub
Что это?Deta Surf — это персональный AI-блокнот, который собирает ваши файлы и веб-страницы в одном месте и позволяет генерировать из них заметки с помощью AI, так что исследование и написание текста происходят в одном потоке, без прыжков между приложениями.
Это приложение для заметок или веб-браузер?И то, и другое сразу: Surf устроен вокруг вкладок, разделенного вида и боковой панели, как браузер, но каждая вкладка может быть заметкой, PDF, сайтом или файлом, о которых можно спрашивать AI и которые можно втянуть в документ.
Как установить Surf?Вы скачиваете десктопную сборку для macOS, Windows или Linux по руководству по установке, на которое ссылается README; сборка из исходников отдельно описана в CONTRIBUTING.md.
Нужен ли свой API-ключ для AI-функций?Да, Surf работает по принципу bring-your-own-key: вы подключаете ключ для облачной модели вроде OpenAI, Claude, DeepSeek или Gemma либо добавляете локальную модель через Ollama и вообще обходитесь без API-ключей.
Можно ли использовать Surf полностью офлайн?Большую часть библиотеки сохраненных файлов и страниц можно открывать и использовать офлайн, но генерация заметок и работа с облачными AI-моделями требуют интернета и API-ключа; только вариант с локальной моделью позволяет обойтись без этого.
Где реально хранятся мои данные?Все, что вы сохраняете, попадает в локальное хранилище на вашей машине под названием SFFS и хранится в открытых прозрачных форматах, а не в облаке вендора.
Что такое Surflets?Surflets — это интерактивные мини-приложения, которые Surf генерирует на лету по промпту, так что вы можете визуализировать или исследовать данные и концепции, не написав ни строчки кода.
Могут ли заметки Surf подтягивать результаты живого веб-поиска?Да, во время написания заметки можно запустить инструмент веб-поиска и задать вопрос с включенным поиском, чтобы результаты и цитаты с глубокими ссылками попали прямо в заметку.
Какой контент можно добавлять в Notebook?Можно добавлять локальные файлы, сайты, видео YouTube, твиты и другие веб-ссылки, а также заметки, созданные прямо в Surf, и организовывать все это в Notebooks.
Зачем создавать Surf вместо отдельных приложений для заметок, браузера и PDF?Большинство инструментов работает только с одним типом медиа за раз; Surf создан для того, чтобы исследование и размышления шли по файлам, веб-страницам и заметкам единым потоком, вместо жонглирования множеством окон и вкладок.
Creator
deta
Size
268.9 MB
Stars
3.6K
Age
11mo
Commits · 90 Days