open-webui/Fu-Jie_openwebui-extensions
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4feb1bdd809b8de7cf65698ca81c24bbbb645bf6
Fu-Jie_openwebui-extensions/plugins/actions/smart-mind-map
History
fujie 4feb1bdd80 feat(smart-mind-map): add GitHub star icon to header controls 
- Add prominent star icon in download button group linking to repository
- Style with gold gradient color (#fbbf24) for visibility
- Hover effect with scale and glow for better UX
- Icon uses yellow color (#fbbf24) with transparent background
- Helps users easily discover and support the project

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-16 00:02:53 +08:00
..
README_CN.md
docs: add OOpenWebUI official newsletter featured recognition to Smart Mind Map, Markdown Normalizer, and Prompt Plus (#52)
2026-02-26 13:12:13 +08:00
README.md
docs: add OOpenWebUI official newsletter featured recognition to Smart Mind Map, Markdown Normalizer, and Prompt Plus (#52)
2026-02-26 13:12:13 +08:00
smart_mind_map.png
chore: update smart mind map plugin image.
2026-02-22 00:00:19 +08:00
smart_mind_map.py
feat(smart-mind-map): add GitHub star icon to header controls
2026-03-16 00:02:53 +08:00

README.md

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: 1.0.0 | Project: OpenWebUI Extensions | License: MIT

🏆 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_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

Reference in New Issue View Git Blame Copy Permalink