Skip to content

blueberrycongee/Lumina-Note

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,512 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lumina Note Logo

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.

GitHub Release License Tauri

CI Security Audit Downloads Last Commit GitHub Stars Commit Activity Platform

Language: English (default) · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Italiano · Português (Brasil) · Русский


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:

Platform Package
Windows .msi / .exe
macOS (Intel) x64.dmg
macOS (Apple Silicon) aarch64.dmg

Screenshots

AI Agent

Knowledge Graph

Editor


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
  • External OpenClaw workspace attachment with memory/plan/artifact affordances, filtered views, and bridge notes

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
  • OpenClaw workspace integration: docs/openclaw-workspace-integration.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+
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


Contributors


License

Apache License 2.0


Star History

Star History Chart