Lumina
Lumina123 downloadsLanguage-Agnostic RAG & MCP Agent powered by Multilingual Embeddings for local AI semantic search.
- Overview
- Scorecard
- Updates25
Lumina is a powerful all-in-one assistant plugin for Obsidian that transforms your knowledge base into a complete AI hub by combining multi-LLM support, zero-config RAG, bidirectional MCP integration, and autonomous AI agents.
English | 한국어 | 日本語 | 简体中文 | 繁體中文 | Español | Deutsch | Français | Português | Русский | Italiano
🌐 Multilingual Environment Optimized! The built-in embedding models and UI are fully localized for multilingual environments. (Translation feedback is always welcome!)
🌟 Main Features
| Feature | Description |
|---|---|
| 💬 Multi-LLM Chat View | A dedicated side panel that understands the context of your notes. Supports everything from powerful cloud models to local LLMs for maximum privacy. |
| 🧠 Zero-Config RAG | Features 100% offline local embeddings to prevent data leaks. Automatically indexes your vault in real-time without complex configurations. |
| ⚡ Inline AI Quick Actions | Highlight text in the editor to instantly summarize, translate, or proofread without interrupting your writing flow. |
| 🤖 Autonomous AI Agent | LLMs autonomously plan and execute complex tasks such as searching, creating, and modifying notes using MCP tools. (Experimental) |
| 🔌 MCP Integration (Client & Server) | A bidirectional, full-stack integration that allows you to use external tools within Obsidian (Client), or let external AIs interact with your notes (Server). (Experimental) |
⚡ Quick Start
Lumina offers two tracks tailored to your skill level. Choose the one that suits you best!
🟢 Track 1: Start in 3 Steps (Recommended for Beginners)
- Install and enable Lumina.
- Go to Settings > Lumina and enter your free API key (Gemini or Groq) obtained from the links below.
- Open any note and ask Lumina a question in the right sidebar panel. That's it! (Once the local RAG indexing is complete in the side panel, conversations based on your notes will be immediately activated.)
🔵 Track 2: Master the Agent (Recommended for Advanced Users)
- Connect a local LLM or your cloud AI of choice in the settings.
- Type
/mcpin the chat to activate Smart Agent Mode. - Issue autonomous commands like, "Find all this week's meeting notes in my vault and compile them into a single summary file."
[!IMPORTANT] 🔒 Secure API Key Storage All API keys you enter are never stored as plain text files. They are securely encrypted and stored locally via Obsidian's built-in
SecretStorage, ensuring your data remains safe.
✨ Detailed Features & Usage (Click to Expand)
💬 Multi-LLM Chat View (Cloud & Local Support)
- Description: Instantly converse with various AI models via a dedicated side panel inside Obsidian. Fully supports powerful cloud models like Gemini and Groq, as well as Local LLMs (Ollama, LM Studio, etc.) for absolute privacy.
- How to use: Click the 💬 icon on the left ribbon or execute
Lumina: Open Chatfrom the command palette. - 💡 Pro Tip: Highlight text in the editor, right-click, and use the context menu to directly inject the selected text into the chat as context for your questions!
🧠 RAG-Powered Chat & Local Embeddings (Absolute Privacy)
- Description: AI gains deep insight into your knowledge base. It autonomously searches relevant notes during conversations and displays similar documents and recommended tags in the side panel, creating smart contextual links.
- Offline Security: Natively supports local embeddings (
ibm-granite). Unless a cloud model is selected, your valuable note data will never leave your device. - Fully Automated: Zero configuration required! Background indexing quietly starts the moment the plugin is enabled, and automatically syncs in real-time (
watchmode) whenever notes are modified.
⚡ Inline Editor AI (Quick Actions)
- Description: Instantly transform text within the markdown editor without breaking your writing flow. Easily handle translation, summarization, grammar correction, and detailed explanations for selected text.
- How to use: Highlight the text and execute Quick Actions via the inline popup menu or command palette. (💡 Tip: Assign hotkeys in Obsidian settings for lightning-fast access!)
🤖 Autonomous AI Agent (Agent Mode) ⚠️
- Description: When activated, the LLM autonomously determines and orchestrates MCP tools to perform tasks. It can complete complex, multi-step operations by combining note searching, reading, writing, and RAG retrieval.
- Local LLM Support: Implements a dedicated parser that supports text-based tool prompting, allowing the agent to function smoothly even in Local LLM environments, not just with high-performance cloud models.
- Safe Tool Composition: The initial version includes only read-focused and safe creation-oriented tools, fundamentally eliminating the risk of existing files being overwritten or deleted.
- Human-in-the-Loop (User Approval): Before performing risky operations such as file modifications, a user confirmation (approval) popup is always displayed.
- Cost Prevention & Limits: Default limits on tool usage count and append character length are applied to prevent AI malfunctions or infinite loops. (These limits can be freely adjusted by the user in advanced settings.)
- How to use: Type the
/mcpcommand in the chat or use the top icon to open the quick popup and enable 'Agent Mode'. (The internal Lumina server will automatically start as needed to execute tools.)
🤖 MCP Integration (Bidirectional Client & Server Support) ⚠️
- Description: Seamlessly bridges Obsidian with the broader AI ecosystem via the Model Context Protocol (MCP). Use Obsidian as an all-in-one AI hub, or leverage it as your AI's second brain!
- 💻 Client Mode (Obsidian-led):
- Interact and work directly with AI within Obsidian.
- Connect numerous external MCP servers (GitHub, local DBs, web search, etc.) to instantly scrape and organize vast amounts of data into your notes.
- 🖥️ Server Mode (External AI-led):
- Exposes 7 tools allowing external AI assistants (Claude, Cursor, etc.) to directly access your vault.
read_active_note,read_note,search_notes,list_notes,rag_search: Provides your vault's context and knowledge to the AI.create_note,append_to_note: Allows the AI to safely write organized ideas directly into your vault (overwriting protection applied).read_daily_note,append_to_daily_note: Read/write integration for today's daily note.- Dangerous operations such as file deletion, moving, or overwriting will be implemented with additional safety measures in future updates.
- How to use: Enable MCP features in the plugin settings and configure the client/server transport method (SSE).
- Note: Agent and MCP features are currently in Experimental (Beta) phase. While various safety nets like overwrite protection and character limits are in place, we recommend initially monitoring operations closely as external AI will directly edit your notes.
🐛 Debug Mode & Bug Reports
You can view all internal data processed by the plugin by enabling Advanced Settings and toggling [Debug Mode] under the [Add-ons & Misc] tab in settings. (Debug logs are not saved until downloaded.)
💡 Helpful Information for Resolution:
- Your OS (Windows, macOS, Linux) and Obsidian version.
- The AI Provider and Model Name used (e.g., OpenAI / gpt-4o, Ollama / llama3).
- The log file downloaded after the error occurred in Debug Mode.
[!IMPORTANT] Since log files may contain chat transcripts, please remove any sensitive information before submitting. Report a Bug (GitHub Issues)
☕ Support & Sponsor
This plugin is distributed 100% free of charge and will be continuously updated. Sponsorships keep me motivated to push out updates even faster!
HealthExcellent
ReviewPassed
About
Turn your vault into an AI hub with a multi-LLM chat side panel, zero‑config local RAG and embeddings, inline AI quick actions for summarizing, translating, and proofreading, and autonomous AI agents.
Index notes offline in real time, run local or cloud models for privacy or scale, and connect external tools via bidirectional MCP integration while supporting multiple languages.Details
Current version
1.1.3
Last updated
3 hours ago
Created
Last week
Updates
25 releases
Downloads
123
Compatible with
Obsidian 1.11.4+
Platforms
Desktop only
License
GPL-3.0
Sponsor