Claude, Codex 등 에이전트와 MCP 및 CLI로 연동하는 로컬 비공개 Markdown 편집기
deta/surf
Deta Surf는 로컬 파일, 웹페이지, 동영상을 LLM 생성 노트와 함께 활용하는 오픈소스 데스크톱 AI 노트북입니다.
대체할 수 있는 제품:Notion AI
NotebookLM
- 스타
- 3,603
- 포크
- 254
- 열린 이슈
- 33
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
Deta Surf는 파일과 웹을 넘나들며 조사하고 생각을 정리할 수 있는 데스크톱 AI 노트북입니다. 노트 앱, PDF 리더, 브라우저 탭을 오갈 필요 없이 PDF, 웹사이트, YouTube 동영상, 로컬 파일을 하나의 라이브러리에 모아 두고 노트에서 바로 질문할 수 있습니다.
라이브러리는 SFFS(Surf Flat File System)라는 스토리지 엔진을 사용해 컴퓨터에 로컬로 저장되며, 개방형 형식으로 관리됩니다. 노트에서는 라이브러리의 모든 리소스를 @ 멘션할 수 있고, 웹 검색 결과를 노트에 가져오거나 출처의 정확한 섹션, 타임스탬프, PDF 페이지로 연결되는 인용을 추가할 수 있습니다. Surf에는 프롬프트를 바탕으로 작은 인터랙티브 애플리케이션을 생성하는 Surflets도 포함되어 있습니다.
Surf는 macOS, Windows, Linux에서 실행되며, Electron 기반으로 Svelte, TypeScript, Rust를 사용해 만들었습니다. 인기 있는 클라우드 모델은 본인의 API key를 연결해 사용할 수 있고, 로컬 언어 모델도 지원합니다.
핵심 기능
- 01로컬 파일, 웹페이지, 동영상을 Notebooks로 정리해 비공개 라이브러리에 저장합니다.
- 02라이브러리의 리소스를 @ 멘션하고 이를 바탕으로 노트를 자동 생성할 수 있습니다.
- 03웹 검색 결과를 노트에 추가하고 인용을 원본 출처로 연결합니다.
- 04코드를 작성하지 않고 프롬프트만으로 인터랙티브 애플릿(Surflets)을 생성합니다.
- 05본인 API key를 사용하는 클라우드 모델과 로컬 언어 모델을 모두 지원합니다.
- 06데이터를 개방형 로컬 형식으로 보관하며 라이브러리의 상당 부분을 오프라인으로 사용할 수 있습니다.
활용 사례
- 강의 동영상이나 PDF를 공부하고 출처가 포함된 답변을 얻습니다.
- 저장한 웹페이지와 문서, 새로운 웹 검색 결과를 바탕으로 주제를 조사합니다.
- 개념이나 데이터셋을 이해하기 위한 인터랙티브 시각화를 만듭니다.
- 민감한 자료를 로컬 모델로 처리하며 비공개 조사 노트를 정리합니다.
빠른 시작
- 1
다운로드 및 설치 방법은 설치 가이드를 확인하세요
- 2
소스에서 빌드하고 로컬에서 개발하려면 CONTRIBUTING.md를 참조하세요
사용 전 알아둘 점
- AI 노트와 Surflets를 사용하려면 대규모 언어 모델이 필요합니다. 널리 사용되는 모델의 API 키를 사용하거나 로컬 모델을 이용하세요.
토픽
자주 묻는 질문
- surf은(는) 무엇인가요?
- Deta Surf는 로컬 파일, 웹페이지, 동영상을 LLM 생성 노트와 함께 활용하는 오픈소스 데스크톱 AI 노트북입니다. Deta Surf는 파일과 웹을 넘나들며 조사하고 생각을 정리할 수 있는 데스크톱 AI 노트북입니다. 노트 앱, PDF 리더, 브라우저 탭을 오갈 필요 없이 PDF, 웹사이트, YouTube 동영상, 로컬 파일을 하나의 라이브러리에 모아 두고 노트에서 바로 질문할 수 있습니다.
- surf은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- surf은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- surf은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. surf의 마지막 커밋은 2026년 8월 24일입니다.
- surf은(는) 어디에 사용할 수 있나요?
- 강의 동영상이나 PDF를 공부하고 출처가 포함된 답변을 얻습니다. 저장한 웹페이지와 문서, 새로운 웹 검색 결과를 바탕으로 주제를 조사합니다. 개념이나 데이터셋을 이해하기 위한 인터랙티브 시각화를 만듭니다. 민감한 자료를 로컬 모델로 처리하며 비공개 조사 노트를 정리합니다.
- surf는 어떻게 설치하나요?
- 다운로드 및 설치 방법은 설치 가이드를 확인하세요 소스에서 빌드하고 로컬에서 개발하려면 CONTRIBUTING.md를 참조하세요
- surf은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/deta/surf
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Gemma, Qwen, DeepSeek, gpt-oss 등 오픈 모델을 CLI, REST API, Python/JavaScript 라이브러리로 로컬 또는 클라우드에서 실행
여러 업스트림 모델 제공업체를 대상으로 라우팅, 키, 할당량, 비용 추적을 제공하며 OpenAI, Claude, Gemini 호환 API를 노출하는 셀프 호스팅 AI 게이트웨이입니다.
클라우드 LLM이나 로컬 모델로 PDF 한 편 또는 여러 편과 대화하고 Zotero 라이브러리 전체를 검색하는 플러그인
게임과 에디터 도구를 LLM·이미지·TTS·3D 생성 API 및 AI 어시스턴트용 MCP 서버에 연결하는 Unreal Engine 플러그인입니다.
RAG 채팅, 시맨틱 검색, 하이라이트, TTS, WebDAV 동기화를 지원하는 로컬 우선 데스크톱·모바일 AI 전자책 리더