# deta/surf

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

Repository: https://github.com/deta/surf
Canonical: https://ross.abutalabs.com/products/surf
Homepage: https://deta.surf
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: local, productivity, rust, svelte, typescript, claude, deepseek, gemma, local-llm, ollama, openai, knowledge-base, knowledge-management, llm
Last push: 2026-08-24T17:05:49+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 81, longevity 22
- inputs: {"age_days": 317, "days_push": 9, "days_rel": 126, "gap_med": 7, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3542, forks 252 (observed 2026-08-28T04:08:09.232760+00:00)

## What it is
Deta Surf is an open-source, local-first AI notebook for macOS, Windows, and Linux that lets users organize files, PDFs, websites, and YouTube videos into notebooks and generate smart notes from them with citations. It supports open model choice including OpenAI, Claude, DeepSeek, Gemma, and local LLMs via Ollama, and stores all data locally in open formats.

## Use cases
- generate notes from pdfs and youtube videos with ai
- organize research files and webpages into notebooks
- chat with my documents locally using local llms
- take ai-assisted notes with citations to sources
- research the web without switching between browser tabs
- create small interactive apps from my notes without coding
- summarize long pdfs and videos
- keep my notes private and stored locally in open formats

## When to choose
- you want a local-first, private AI notebook with open data formats
- you want to bring your own LLM key or run local models via Ollama
- you research across mixed media like PDFs, websites, and videos and want citations back to sources
- you value open source and cross-platform desktop support

## When to avoid
- you need a lightweight plain-text note app without AI features
- you want a mobile or web-only solution
- you dislike Electron-based desktop apps or need minimal resource usage
- you need mature, fully polished features - Surf is still in beta

## Facets
- artifact type: application
- maturity: active
- function: llm-inference, rag, chat-interface, web-scraping, pdf, documentation, search-engine, data-visualization
- domain: developer-tools, large-language-models, web-development, self-hosted, privacy
- platform: windows, cross-platform
- tags: ai-notebook, local-first, knowledge-base, note-taking, ollama, open-source, smart-notes, research-tool, svelte, rust, typescript, citations, youtube-notes, pdf-notes, surflets, knowledge-management, natural-language-processing, macos, linux, desktop, electron

## Member repositories
- deta/surf (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:09.232760+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:34:28.042281+00:00, confidence not recorded.
  - readme: https://github.com/deta/surf (fetched 2026-08-28T04:08:09.232760+00:00, sha 550dd18efc45)
  - homepage: https://deta.surf (fetched 2026-08-29T09:28:59.454056+00:00, sha fb33b2147a19)
  - site_page: https://deta.surf/faq (fetched 2026-08-29T09:28:59.456561+00:00, sha 57797f7b167c)
- Data as of 2026-08-30T08:39:29.467469+00:00.