ZettelAgent

AI-Powered Zettelkasten Desktop Agent

Your second brain that thinks, reconciles contradictions, and evolves your notes.
All from a local Markdown folder — No Docker, no cloud, no accounts.

English · 中文 · 日本語 · 한국어

🚀 Download from Releases → Install → Use

No Node.js, no Docker, no extra model downloads. The ~300MB installer already includes the nomic embedding model, ONNX Runtime WASM, and PP-OCR — fully offline on your local Markdown folder.

✨ Core Capabilities

🔍 Hybrid Search

Full-text search + semantic vector search with three modes. Ask questions in natural language — AI answers based on your notes.

🤖 AI Agent

60 built-in tools, 3 specialized agents working together. Auto-organize notes, detect contradictions, generate link suggestions, batch operations. Write actions require user approval.

📈 Knowledge Graph

Discovers hidden semantic connections between notes. PageRank importance scoring, community clustering, local graph, shortest path discovery.

🎨 Intelligent Canvas

Obsidian-compatible whiteboard with Bézier curves, PDF/web embeds, smart groups. AI auto-layout, direct Agent control.

🧠 Built-in Embedding Engine

nomic-embed-text-v1.5 is bundled in the installer (WASM, optional WebGPU). Zero configuration, no API keys, no download after install.

🔒 Local-First

All data stays on your machine. AI writes into  blocks, never touching your original content. Supports Zettelkasten, PARA, CODE, GTD and 8 methodologies total.

📸 Interface Showcase

Knowledge Graph View	AI Agent in Action

Knowledge Graph — Interactive Exploration

Knowledge Graph Interactive

🏁 Quick Start (end users)

Download the installer from Releases
Install and open the app — no extra downloads
Configure your LLM API in Settings (OpenAI / Claude / Gemini / Ollama and more)

🛠 Build from Source (developers)

git clone https://github.com/Poetrynan/ZettleAgent.git
cd ZettleAgent
npm install
npm run tauri dev    # Development mode (auto-generates src-tauri/gen/schemas/)

Note: src-tauri/gen/ is auto-generated by Tauri and excluded from git.
The first npm run tauri dev run creates the schema files referenced by capabilities/default.json. No manual action is needed.

To produce a Release installer:

npm run tauri build  # Runs build:prod (fetches models, bundles everything)

Large assets (embedding model, ORT WASM, fonts) are not in the git repo. tauri build downloads and bundles them automatically; end users never run this step.

💻 System Requirements

Platforms	Installer size	Recommended RAM
Windows (fully supported) · macOS / Linux (CI builds, experimental)	~300MB (models included)	8GB+ (local embedding)

⚔️ Comparison

	ZettelAgent	Obsidian + Plugins	Notion AI	Logseq
Local-first, zero cloud	✅	✅	❌	✅
Built-in AI Agent (60 tools + 3 agents)	✅	⚠️ 3rd-party	⚠️ Limited	❌
Hybrid search (FTS + Vector RRF)	✅	⚠️ Plugin	❌	❌
Auto-reconciliation	✅	❌	❌	❌
AI Intelligent Canvas (groups + layout)	✅	✅	❌	✅
Built-in Embedding (in installer, zero download)	✅	❌	❌	❌
AI Long-term Memory (cross-session)	✅	❌	⚠️	❌
Selection AI (Rewrite/Summarize/Translate)	✅	⚠️ Plugin	✅	❌
Web Search (DuckDuckGo)	✅	⚠️ Plugin	⚠️	❌
Multi-format Import (PDF/DOCX/OCR)	✅	⚠️ Plugin	⚠️	❌
Database View (Notion-style table)	✅	⚠️ Dataview	✅	❌
Chat History Persistence	✅	❌	✅ Cloud	❌
Approval Gate (write safety)	✅	❌	❌	❌
Temporal Knowledge Evolution	✅	❌	❌	❌
Knowledge Gap Analysis	✅	❌	❌	❌
8 Methodology Support	✅	⚠️ Plugin	❌	❌
MCP Protocol (SSE + stdio)	✅	❌	❌	❌
One installer, zero runtime deps	✅	⚠️ Electron	❌ Web	⚠️ Electron

🤝 Contributing

We welcome contributions from the community! Whether you're fixing bugs, improving documentation, or adding new features, your help is appreciated.

Please read our Contributing Guidelines before submitting a pull request.

🙏 Acknowledgments

Built on the shoulders of: Zettelkasten · Obsidian · sqlite-vec · Tauri · pulldown-cmark · DeepSeek

📜 License

Apache License 2.0 — Free to use and modify. Credit the original author in commercial products. See LICENSE.