// productivity · deta/surf

surf

Deta Surf — personal AI notebooks that organise files and webpages and generate notes from them.

★ 3.6k stars⑂ 255 forksApache-2.0updated 2026-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

surf is an open-source productivity project by deta (deta/surf on GitHub). It has 3,598 GitHub stars and 255 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 24 August 2026.

Repository
deta/surf
GitHub stars
3,598
Forks
255
License
Apache-2.0
Last updated on GitHub
24 August 2026
Category
Productivity
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Multi-media library and notebooks

Collect files and webpages into notebooks and work with them in one place.

Smart notes from sources

Generate notes from a YouTube video, a PDF or other sources, and ask questions against them.

Web-searching notes

Notes can use a web-search tool when a question needs fresh information.

Surflets

Generate small apps inside Surf with the app-generation tool.

Tabs, split view and sidebar

A browser-like workspace with tabs and split view for research-heavy work.

Open model choice

Use local models or hosted ones — the project emphasises local, open data and user choice.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/deta/surf.git
    cd surf
  2. Install Surf

    Download Surf from deta.surf or follow the installation guide in the repo for your platform.

    git clone https://github.com/deta/surf.git
    cd surf  # see docs/INSTALL.md for the exact install/build steps
  3. Try the starter flows

    Open a YouTube video or PDF and ask a question, or create a Surflet, as the README's TL;DR suggests.

    # In Surf: visit a YouTube video and ask a question  # see README
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains surf?

It is maintained by deta on GitHub (deta/surf), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under Apache-2.0, which permits use, modification and commercial redistribution, with licence/notice retention.

Does it need a paid API key?

You choose — Surf works with local models (no key) or hosted providers with your own API key.

How does it compare to Notion or Obsidian with AI plugins?

Compared with Notion or Obsidian with AI plugins, surf's distinguishing focus is: deta Surf — personal AI notebooks that organise files and webpages and generate notes from them. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/deta/surf (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Productivity

Memos

Memos — a personal timeline for quick notes: capture short memos in seconds, find them later by search, tag or date; open source and self-hosted

★ 63.9k starsMIT
View guide →
Productivity

Trilium

Trilium — build your personal knowledge base: a hierarchical notes app with strong encryption, scripting and sync, maintained by the TriliumNext community

★ 38.4k starsAGPL-3.0
View guide →
Productivity

whisper

A utility for take notes with your voice & transform them with AI.

★ 513 starsMIT
View guide →
Productivity

edgeever

An open, AI-native Evernote alternative: three-pane notes with native MCP, free on Cloudflare or Docker.

★ 2.1k starsAGPL-3.0
View guide →
Productivity

Logseq

Logseq — a privacy-first platform for knowledge management: an outliner over your local Markdown files, with a graph, journals and spaced repetition built in

★ 45.3k starsAGPL-3.0
View guide →
Productivity

Joplin

Joplin — the privacy-focused note-taking app: Markdown notes and to-dos on every platform, offline-first, with end-to-end encrypted sync you control

★ 56.8k starsCustom (check repo)
View guide →
// alternatives

Alternatives in Productivity

The most-starred other Productivity projects in the LibreAI catalogue — the realistic shortlist if surf is not the right fit.

Get surf

Free and open — grab the source, star the repo, and start creating.