Files

fujie 31496a191e Add Batch Install Plugins installation instructions to various plugins and filters

- Updated README files for the following plugins to include installation instructions using Batch Install Plugins:
  - deep-dive
  - export_to_docx
  - export_to_excel
  - flash-card
  - infographic
  - smart-mind-map
  - async-context-compression
  - chat-session-mapping-filter
  - folder-memory
  - github_copilot_sdk_files_filter
  - markdown_normalizer
  - github-copilot-sdk
  - iflow-sdk-pipe
  - openwebui-skills-manager
  - smart-mind-map-tool

- Added important notes regarding the removal of the official OpenWebUI Community version before installation.

2026-03-16 17:22:24 +08:00

6.4 KiB

Raw Permalink Blame History

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

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

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 🛠️

Install: Upload the smart_mind_map.py file 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-flash for daily use.
Export Quality: Use PNG for presentations and SVG for further editing.

Changelog

See the full history on GitHub: OpenWebUI Extensions

6.4 KiB Raw Permalink Blame History