e92ad60e3f
- update plugin README badges to use Top <1% and a clearer contribution icon - reorder badge rows across mirrored docs and templates Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
5.9 KiB
5.9 KiB
Smart Mind Map - Mind Mapping Generation Plugin
Smart Mind Map is a powerful OpenWebUI action plugin that intelligently analyzes long-form text content and automatically generates interactive mind maps, helping users structure and visualize knowledge.
| By Fu-Jie · v1.0.0 | ⭐ Star this repo |
|---|
 |
 |
 |
 |
 |
 |
 |
|---|
🏆 Featured by OpenWebUI Official — This plugin was recommended in the official OpenWebUI Community Newsletter: February 3, 2026
What's New in v1.0.0
Direct Embed & UI Refinements
- Native Multi-language UI (i18n): The plugin interface (buttons, settings, status) now automatically adapts to your browser's language setting for a seamless global experience.
- Direct Embed Mode: Introduced a native-like inline display mode for Open WebUI 0.8.0+, enabling a seamless full-width canvas.
- Adaptive Auto-Sizing: Mind map now dynamically scales its height and perfectly refits to the window to eliminate scrollbar artifacts.
- Subdued & Compact UI: Completely redesigned the header tooling bar to a slender, single-line configuration to maximize visual rendering space.
- Configurable Experience: Added
ENABLE_DIRECT_EMBED_MODEvalve to explicitly toggle the new inline rendering behavior.
Key Features 🔑
- ✅ Intelligent Text Analysis: Automatically identifies core themes, key concepts, and hierarchical structures.
- ✅ Native Multi-language UI: Automatic interface translation (i18n) based on system language for a native feel.
- ✅ Interactive Visualization: Generates beautiful interactive mind maps based on Markmap.js.
- ✅ Direct Embed Mode: (Optional) For Open WebUI 0.8.0+, render natively inline to fill entire UI width.
- ✅ High-Resolution PNG Export: Export mind maps as high-quality PNG images (9x scale).
- ✅ Complete Control Panel: Zoom controls, expand level selection, and fullscreen mode within a compact toolbar.
- ✅ Theme Switching: Manual theme toggle button with automatic theme detection.
- ✅ Image Output Mode: Generate static SVG images embedded directly in Markdown for cleaner history.
How to Use 🛠️
- Install: Upload the
smart_mind_map.pyfile in OpenWebUI Admin Settings -> Plugins -> Actions. - Configure: Ensure you have an LLM model configured (e.g.,
gemini-2.5-flash). - Trigger: Enable the "Smart Mind Map" action in chat settings and send text (at least 100 characters).
- Result: The mind map will be rendered directly in the chat interface.
Configuration (Valves) ⚙️
| Parameter | Default | Description |
|---|---|---|
show_status |
true |
Whether to display operation status updates. |
LLM_MODEL_ID |
gemini-2.5-flash |
LLM model ID for text analysis. |
MIN_TEXT_LENGTH |
100 |
Minimum text length required for analysis. |
CLEAR_PREVIOUS_HTML |
false |
Whether to clear previous plugin-generated HTML content. |
MESSAGE_COUNT |
1 |
Number of recent messages to use for generation (1-5). |
OUTPUT_MODE |
html |
Output mode: html (interactive) or image (static). |
ENABLE_DIRECT_EMBED_MODE |
false |
Enable Direct Embed Mode (Open WebUI 0.8.0+ native layout) instead of Legacy Mode. |
⭐ Support
If this plugin has been useful, a star on OpenWebUI Extensions is a big motivation for me. Thank you for the support.
Troubleshooting ❓
- Plugin not working?: Check if the action is enabled in the chat settings.
- Text too short: Ensure input text contains at least 100 characters.
- Rendering failed: Check browser console for errors related to Markmap.js or D3.js.
- Submit an Issue: If you encounter any problems, please submit an issue on GitHub: OpenWebUI Extensions Issues
Technical Architecture
- Markmap.js: Open-source mind mapping rendering engine.
- PNG Export: 9x scale factor for print-quality output (~1-2MB file size).
- Theme Detection: 4-level priority detection (Manual > Meta > Class > System).
- Security: XSS protection and input validation.
Best Practices
- Text Preparation: Provide text with clear structure and distinct hierarchies.
- Model Selection: Use fast models like
gemini-2.5-flashfor daily use. - Export Quality: Use PNG for presentations and SVG for further editing.
Changelog
See the full history on GitHub: OpenWebUI Extensions