---

Why Lumina Note

• 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 agents work as one system.
• AI that can actually act: Agent mode supports real editing, planning, and automation tasks.

---

Download

---

Screenshots

---

Features

AI workspace

• Agent mode for editing, planning, and task automation
• Multi-provider: OpenAI, Anthropic (Claude), Google (Gemini), DeepSeek, Moonshot (Kimi), Zhipu (GLM), MiMo, Qwen, Groq, OpenRouter, Ollama, plus any OpenAI-compatible endpoint
• Orchestrated agent runtime for heavier tasks, with a fast path for simpler requests

Editor and knowledge graph

• Markdown source / live preview / reading modes
• Bidirectional links with [[WikiLinks]]
• LaTeX, Mermaid, and code highlighting
• Knowledge graph (global) and local graph (per-note neighborhood)

Reading and capture

• Built-in PDF reader with highlight, underline, and annotations
• Save annotation output as Markdown
• Send selected content directly into AI context

Extra capabilities

• Real-time voice input
• WebDAV sync
• Flashcard review
• Conversation export
• Skill manager (workspace / user / built-in agent skills)
• 15 themes

Mobile companions

• Native iOS app (SwiftUI) and Android app (Kotlin + Jetpack Compose) under mobile/
• Pair to your desktop with the built-in Mobile Gateway (QR code + token) for direct LAN sync
• Cross-network access through the optional self-hosted relay — see docs/self-host.md

Plugin ecosystem (Developer Preview)

• Load plugins from workspace / user / built-in directories
• Runtime permission model for plugin capabilities
• Slash command extension API
• Developer guide: docs/plugin-ecosystem.md

---

Quick Start

1. Install Lumina Note from Releases.
2. Choose a local folder as your vault on first launch.
3. Configure a model provider and API key in the AI panel, then optionally choose your preferred model.
4. Create your first note and start linking with [[WikiLinks]].

---

Guides

Recommended user guides

• English: docs/user-flow.md
• 简体中文: docs/user-flow.zh-CN.md
• 日本語: docs/user-flow.ja.md

Self-hosted relay (cross-network mobile access)

• English: docs/self-host.md
• 简体中文: docs/self-host.zh-CN.md

---

Build from Source

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)

---

Tech Stack

• Desktop: Electron 41 (Chromium + Node.js main process)
• Frontend: React 18, TypeScript, Tailwind CSS
• Editor: CodeMirror 6
• State: Zustand
• Agent runtime: Vercel AI SDK (ai)
• Mobile: SwiftUI (iOS), Kotlin + Jetpack Compose (Android) — mobile/
• Self-host relay (optional): Rust + axum + sqlx + Yjs CRDT — server/

---

Open Source Components

• Editor core: codemirror-live-markdown

---

Contributors

---

License

Apache License 2.0

---

Star History