Local-first AI note-taking app
Your notes stay on your device. Lumina Note helps you write, connect, search, and refine knowledge with AI while keeping data ownership in your hands.
Language: English (default) · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Italiano · Português (Brasil) · Русский
- Local-first by design: your vault is local, and you decide what gets sent to model providers.
- Knowledge-centered workflow: Markdown editing, WikiLinks, graph view, and AI retrieval work as one system.
- AI that can actually act: Chat, Agent, and Codex mode support real editing, planning, and automation tasks.
Get the latest build from Releases:
| Platform | Package |
|---|---|
| Windows | .exe (NSIS) |
| macOS (Universal) | .dmg / .zip |
| Linux | .AppImage |
- Modes:
Chat/Agent/Codex(embedded VS Code extension in the sidebar) - Multi-provider support: OpenAI / Anthropic (Claude) / DeepSeek / Gemini / Moonshot / Groq / OpenRouter / Ollama
- Simple purpose-based model routing:
Main Model/Chat Model/Complex Task Model - Orchestrated agent runtime for heavier tasks, with a fast path for simpler requests
- Local semantic retrieval (RAG) from your vault
- Markdown source / live preview / reading modes
- Bidirectional links with
[[WikiLinks]] - LaTeX, Mermaid, and code highlighting
- Graph visualization for relationships across notes
- Built-in PDF reader with highlight, underline, and annotations
- Save annotation output as Markdown
- Send selected content directly into AI context
- Bilibili video notes with danmaku timestamp sync
- Real-time voice input
- Database views (table / kanban)
- WebDAV sync
- Flashcard review
- 15 themes
- Load plugins from workspace / user / built-in directories
- Runtime permission model for plugin capabilities
- Slash command extension API
- Developer guide:
docs/plugin-ecosystem.md
- Install Lumina Note from Releases.
- Choose a local folder as your vault on first launch.
- Configure a model provider and API key in the AI panel, then optionally set
Main/Chat/Complex Taskmodels in Dynamic Routing. - Create your first note and start linking with
[[WikiLinks]].
- English:
docs/user-flow.md - 简体中文:
docs/user-flow.zh-CN.md - 日本語:
docs/user-flow.ja.md
- English:
docs/self-host.md - 简体中文:
docs/self-host.zh-CN.md
Requirements:
- Node.js 22+
git clone https://github.com/blueberrycongee/Lumina-Note.git
cd Lumina-Note
npm install
npm run dev # dev (electron-vite + Electron)
npm run build # production bundle into out/
npm run dist:mac # sign + package a dmg/zip (also dist:win, dist:linux)- Framework: Electron 41 (Chromium + Node.js in the main process)
- Frontend: React 18, TypeScript, Tailwind CSS
- Editor: CodeMirror 6
- State: Zustand
- Agent runtime: Vercel AI SDK + MCP TS SDK (
@modelcontextprotocol/sdk)
- Editor core: codemirror-live-markdown