surf logo

surf

deta/surf

Tools for organizing files and webpages locally to generate notes using personal AI notebooks.

GraphCanon updated Aug 12, 2026 · GitHub synced Aug 12, 2026

45views this month

3.5k stars251 forksLast push Aug 10, 2026 TypeScript Apache-2.0

Decision brief

surf is an open-source tool for managing personal notes by integrating local or remote AI models to process files and webpages.

Good fit when

  • Need a robust integration with both local and remote language models for comprehensive note creation
  • Wish to work in a fully localized environment without cloud storage dependencies

Avoid when

  • Prefer using proprietary, closed-source tools that do not allow open model choices
  • Require extensive cloud-based collaboration features among multiple users

Observed Jul 17, 2026 · Source: enrich:decision_facts

Verify the decision

Adoption

Package downloads where a registry match exists. GitHub stars (3,522) are secondary evidence.

npm downloads (30d)
389·npm downloads API·Aug 12, 2026

Maintenance and security

Full trust report
Maintenance
Very active (2d since push)
As of Aug 12, 2026
Provenance
Not a fork · Organization account
As of Aug 12, 2026
Security (OSV)
No lockfile
As of Jul 15, 2026

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

npm install surf
npm

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

A personal knowledge management solution that supports integration with local or remote large language models, allowing users to create and organize notes from various sources such as files and webpages in a local environment.

Capability facts

MCP server
No MCP server detected

Source: repo_scan · Aug 12, 2026

Languages
typescript, javascript

Source: github.language+package.json · Aug 12, 2026

Categories

Tags

README

Installation Checkout the installation guide for detailed instructions. For building from source and local development, see CONTRIBUTING.md. License The source code for this project is licensed under the Apache 2.0 license, with the following exceptions: 1. Our patch for the @gho...

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.