deta /surf

Personal AI Notebooks. Organize files & webpages and generate notes from them. Open source, local & open data, open model choice (incl. local).

★ 3,617⑂ 252👁 13▤ 33
TypeScriptCreated 2025-10-20deta.surf
3,617
stars
+0+2+29
252
forks
13
watchers
–
prs
–
issues
33
releases
–
discussions

README

!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

- _YouTube Notes_: visit a YouTube video and ask a question
- _PDF Notes_: open a PDF and ask a question
- _Create an applet_: use the "app generation" tool and ask for an app
- _Notes that search the web_: use the "web search" tool and ask a question with "search" in it

 Features

 Multi-Media Library & Notebooks

!notebooks

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

- Support for local files, sites & links from the web (YouTube, Tweets & more), or create media directly in Surf.
- Organize this library into Notebooks.
- Open and use much of your library offline.
- Use your library to power Surf’s AI features.

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).

- @-mention and auto-generate from any tab, website or any resource in your library.
- Trigger web searches to do research, and bring the results back in your notes.
- Integrated citations deeplinked to original sources, whether a section on a webpage, a timestamp in a video, or a page in a PDF.
- Generate interactive applications without writing code using Surflets.
- Paste in images, tables or data from other applications and have Surf understand and incorporate them.
- Use rich formating, code blocks, to-do lists and more in your notes.

Read more.

 Tabs, Split View & Sidebar

!split

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

- Open local notes, files or web pages in tabs.
- Split view allows you to view and interact with multiple resources side by side.
- The sidebar provides quick access to your Notebooks & 

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON