Files
Fu-Jie_openwebui-extensions/plugins/actions/smart-mind-map/README.md
fujie ad2773e8f1 Update plugin documentation for various filters and actions
- Updated README.md and README_CN.md for the infographic plugin to reflect new features and bug fixes in version 1.5.0, including context-aware generation and language synchronization.
- Revised README.md and README_CN.md for the smart mind map plugin to include support for user feedback and a changelog.
- Enhanced README.md and README_CN.md for the async context compression filter with critical fixes and improved compatibility details.
- Introduced initial release notes for the folder memory filter, detailing its core features and installation instructions.
- Updated markdown normalizer documentation to synchronize version numbers and improve clarity on configuration options.
- Revised GitHub Copilot SDK documentation to enhance installation instructions and troubleshooting sections, including a new changelog.
2026-01-29 03:22:21 +08:00

3.5 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.

Author: Fu-Jie | Version: 0.9.2 | Project: Awesome OpenWebUI | License: MIT

What's New in v0.9.2

Language Rule Alignment

  • Input Language First: Mind map output now strictly matches the input text language.
  • Consistent Behavior: Matches the infographic language rule for predictable multilingual output.

Key Features 🔑

  • Intelligent Text Analysis: Automatically identifies core themes, key concepts, and hierarchical structures.
  • Interactive Visualization: Generates beautiful interactive mind maps based on Markmap.js.
  • 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.
  • 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 🛠️

  1. Install: Upload the smart_mind_map.py file in OpenWebUI Admin Settings -> Plugins -> Actions.
  2. Configure: Ensure you have an LLM model configured (e.g., gemini-2.5-flash).
  3. Trigger: Enable the "Smart Mind Map" action in chat settings and send text (at least 100 characters).
  4. 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).

Support

If this plugin has been useful, a star on Awesome OpenWebUI 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: Awesome OpenWebUI 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

  1. Text Preparation: Provide text with clear structure and distinct hierarchies.
  2. Model Selection: Use fast models like gemini-2.5-flash for daily use.
  3. Export Quality: Use PNG for presentations and SVG for further editing.

Changelog

See the full history on GitHub: Awesome OpenWebUI