Skip to content

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
followers points top contributions downloads saves views

๐Ÿ† Featured by OpenWebUI Official โ€” This plugin was recommended in the official OpenWebUI Community Newsletter: February 3, 2026

Install with Batch Install Plugins

If you already use Batch Install Plugins from GitHub, you can install or update this plugin with:

Install plugin from Fu-Jie/openwebui-extensions

When the selection dialog opens, search for this plugin, check it, and continue.

[!IMPORTANT] If the official OpenWebUI Community version is already installed, remove it first. After that, Batch Install Plugins can keep this plugin updated in future runs.

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_MODE valve 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 ๐Ÿ› ๏ธ

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

  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: OpenWebUI Extensions