Your second brain that thinks, reconciles contradictions, and evolves your notes.
All from a local Markdown folder — No Docker, no cloud, no accounts.
🚀 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
- 📸 Interface Showcase
- 🏁 Quick Start (end users)
- 🛠 Build from Source (developers)
- 💻 System Requirements
- ⚔️ Comparison
- 🤝 Contributing
- 🙏 Acknowledgments
- 📜 License
Full-text search + semantic vector search with three modes. Ask questions in natural language — AI answers based on your notes.
60 built-in tools, 3 specialized agents working together. Auto-organize notes, detect contradictions, generate link suggestions, batch operations. Write actions require user approval.
Discovers hidden semantic connections between notes. PageRank importance scoring, community clustering, local graph, shortest path discovery.
Obsidian-compatible whiteboard with Bézier curves, PDF/web embeds, smart groups. AI auto-layout, direct Agent control.
nomic-embed-text-v1.5 is bundled in the installer (WASM, optional WebGPU). Zero configuration, no API keys, no download after install.
All data stays on your machine. AI writes into <!-- @generated --> blocks, never touching your original content. Supports Zettelkasten, PARA, CODE, GTD and 8 methodologies total.
- 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)
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 firstnpm run tauri devrun creates the schema files referenced bycapabilities/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.
| Platforms | Installer size | Recommended RAM |
|---|---|---|
| Windows (fully supported) · macOS / Linux (CI builds, experimental) | ~300MB (models included) | 8GB+ (local embedding) |
| ZettelAgent | Obsidian + Plugins | Notion AI | Logseq | |
|---|---|---|---|---|
| Local-first, zero cloud | ✅ | ✅ | ❌ | ✅ |
| Built-in AI Agent (60 tools + 3 agents) | ✅ | ❌ | ||
| Hybrid search (FTS + Vector RRF) | ✅ | ❌ | ❌ | |
| 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) | ✅ | ✅ | ❌ | |
| Web Search (DuckDuckGo) | ✅ | ❌ | ||
| Multi-format Import (PDF/DOCX/OCR) | ✅ | ❌ | ||
| Database View (Notion-style table) | ✅ | ✅ | ❌ | |
| Chat History Persistence | ✅ | ❌ | ✅ Cloud | ❌ |
| Approval Gate (write safety) | ✅ | ❌ | ❌ | ❌ |
| Temporal Knowledge Evolution | ✅ | ❌ | ❌ | ❌ |
| Knowledge Gap Analysis | ✅ | ❌ | ❌ | ❌ |
| 8 Methodology Support | ✅ | ❌ | ❌ | |
| MCP Protocol (SSE + stdio) | ✅ | ❌ | ❌ | ❌ |
| One installer, zero runtime deps | ✅ | ❌ Web |
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.
Built on the shoulders of: Zettelkasten · Obsidian · sqlite-vec · Tauri · pulldown-cmark · DeepSeek
Apache License 2.0 — Free to use and modify. Credit the original author in commercial products. See LICENSE.