https://github.com/blueberrycongee/lumina-note
Lumina Note - A modern Markdown note-taking app with live preview, bidirectional links, and AI assistant
https://github.com/blueberrycongee/lumina-note
ai ai-agents desktop-app knowledge-graph local-first markdown note-taking own-your-data pdf-reader rag react rust second-brain semantic-search tauri typescript
Last synced: 24 days ago
JSON representation
Lumina Note - A modern Markdown note-taking app with live preview, bidirectional links, and AI assistant
- Host: GitHub
- URL: https://github.com/blueberrycongee/lumina-note
- Owner: blueberrycongee
- License: apache-2.0
- Created: 2025-11-28T12:34:30.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-06T19:44:35.000Z (30 days ago)
- Last Synced: 2026-03-06T22:47:04.003Z (30 days ago)
- Topics: ai, ai-agents, desktop-app, knowledge-graph, local-first, markdown, note-taking, own-your-data, pdf-reader, rag, react, rust, second-brain, semantic-search, tauri, typescript
- Language: TypeScript
- Homepage:
- Size: 37.7 MB
- Stars: 697
- Watchers: 0
- Forks: 74
- Open Issues: 12
-
Metadata Files:
- Readme: README.en.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Lumina Note
**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.
[](https://github.com/blueberrycongee/Lumina-Note/releases)
[](LICENSE)
[](https://tauri.app/)
[](https://github.com/blueberrycongee/Lumina-Note/actions/workflows/ci.yml)
[](https://github.com/blueberrycongee/Lumina-Note/actions/workflows/security-audit.yml)
[](https://github.com/blueberrycongee/Lumina-Note/releases)
[](https://github.com/blueberrycongee/Lumina-Note/commits/main)
[](https://github.com/blueberrycongee/Lumina-Note/stargazers)
[](https://github.com/blueberrycongee/Lumina-Note/commits/main)
**Language**: English · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [日本語](./README.ja.md) · [한국어](./README.ko.md) · [Español](./README.es.md) · [Français](./README.fr.md) · [Deutsch](./README.de.md) · [Italiano](./README.it.md) · [Português (Brasil)](./README.pt-BR.md) · [Русский](./README.ru.md)
---
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 retrieval work as one system.
- **AI that can actually act**: Chat, Agent, Deep Research, and Codex mode support real editing and research tasks.
---
Download
Get the latest build from [Releases](https://github.com/blueberrycongee/Lumina-Note/releases):
| Platform | Package |
|----------|---------|
| Windows | `.msi` / `.exe` |
| macOS (Intel) | `x64.dmg` |
| macOS (Apple Silicon) | `aarch64.dmg` |
---
Screenshots
---
Features
AI workspace
- Modes: `Chat` / `Agent` / `Deep Research` / `Codex` (embedded VS Code extension in the sidebar)
- Multi-provider support: OpenAI / Anthropic (Claude) / DeepSeek / Gemini / Moonshot / Groq / OpenRouter / Ollama
- Local semantic retrieval (RAG) from your vault
Editor and knowledge graph
- Markdown source / live preview / reading modes
- Bidirectional links with `[[WikiLinks]]`
- LaTeX, Mermaid, and code highlighting
- Graph visualization for relationships across notes
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
- Bilibili video notes with danmaku timestamp sync
- Real-time voice input
- Database views (table / kanban)
- WebDAV sync
- Flashcard review
- 15 themes
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.
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 20+ (recommended 20.11.1)
- Rust 1.70+
```bash
git clone https://github.com/blueberrycongee/Lumina-Note.git
cd Lumina-Note
npm install
npm run tauri dev
```
---
Tech Stack
- Framework: Tauri v2 (Rust + WebView)
- Frontend: React 18, TypeScript, Tailwind CSS
- Editor: CodeMirror 6
- State: Zustand
- Vector storage: SQLite
---
Open Source Components
- Editor core: [codemirror-live-markdown](https://github.com/blueberrycongee/codemirror-live-markdown)
- Rust orchestration runtime: [forge](https://github.com/blueberrycongee/forge)
---
Contributors
---
License
[Apache License 2.0](LICENSE)
---
Star History
[](https://star-history.com/#blueberrycongee/Lumina-Note&Date)