FlowMap - Advanced Flowchart Generator Plugin for Dify

Author: sawyer-shi
Email: [email protected]
Version: 0.0.3
Type: Dify Plugin
Repository: GitHub

Version Information

• Current Version: v0.0.3
• Release Date: 2026-03-15
• Compatibility: Dify Plugin Framework
• Python Version: 3.12+

Version History

• v0.0.3 (2026-03-15): Updated element overlap prevention algorithm to ensure elements do not cover each other.
• v0.0.2 (2025-10-18): Added free layout flowchart functionality, fixed bugs from previous versions, improved software stability and reliability.
• v0.0.1 (2025-09-12): Initial release with smart branch detection, colorful arrow labels, and advanced layout optimization

Description

A powerful flowchart generation plugin that converts Markdown and Mermaid syntax to beautiful, intelligent flowcharts with advanced layout optimization and branch-aware positioning.

✨ Key Features

• 🎨 Intelligent Layout System
  • Smart branch detection and free layout for complex flowcharts
  • Grid layout for linear processes
  • Automatic canvas sizing to prevent element overflow
• 📐 Multiple Layout Directions
  • Left-to-right layout (LR)
  • Top-to-bottom layout (TB)
  • Branch-aware positioning
• 🌈 Colorful Arrow Labels
  • Intelligent color mapping based on label semantics
  • Support for Chinese and English labels
  • Customizable color themes
• 📝 Dual Format Support
  • Full Mermaid syntax support with labeled arrows
  • Markdown list conversion
  • Automatic text type detection
• 🎭 Rich Themes
  • Modern theme with gradient effects
  • Business professional theme
  • Classic minimalist theme
  • Custom theme support
• 🔧 Local Processing
  • Local Generation: Mind maps generated locally, no API Key required, no external network or services needed
  • Secure & Reliable: Data stays private, completely offline processing, protects user privacy
  • No external API dependencies
  • Fast generation with matplotlib
  • Privacy-focused design
  • High-quality PNG output

🚀 Quick Start

1. Download from Dify Plugin Marketplace

   • Go to Dify Plugin Marketplace
   • Search and download plugin
   • Enable FlowMap plugin in your workspace

2. LLM Integration ⭐

   • Add an LLM node in your Dify workflow
   • Use the simplest prompt: "Summarize user input #context# into Mermaid flowchart text format"
   • Connect LLM output to FlowMap plugin input

Basic Usage Examples

Top-to-bottom layout

Left-to-right layout

📚 API Reference

Mermaid Left-Right Tool

Input Parameters:

• (string, required): Mermaid syntax flowchart text
• (string, optional): Theme name (modern/business/classic)

Output:

• Success: PNG image + text summary
• Format: "Successfully generated left-right layout flowchart. File size: X.XXM. Contains X nodes and X connections."

Mermaid Top-Bottom Tool

Input Parameters:

• (string, required): Mermaid syntax flowchart text
• (string, optional): Theme name (modern/business/classic)

Output:

• Success: PNG image + text summary
• Format: "Successfully generated top-bottom layout flowchart. File size: X.XXM. Contains X nodes and X connections."

🛠️ Advanced Features

Smart Branch Detection

The plugin automatically detects branching scenarios in your flowchart and switches layout algorithms:

• Linear Flow: Uses grid layout for optimal alignment
• Branching Flow: Uses free layout to prevent overlap

Colorful Arrow Labels

Supports labeled arrows with intelligent color mapping

Theme Customization

Available themes with different visual styles:

• Modern: Clean design with gradients
• Business: Professional corporate style
• Classic: Traditional minimalist look

🔧 Development

Project Structure

🔍 Technical Details

Branch-Aware Layout Algorithm

• Branch Detection: Automatically identifies decision nodes with multiple outgoing connections
• Free Layout: Hierarchical positioning based on connection levels
• Canvas Adaptation: Dynamic canvas sizing (up to 2.5x node count)
• Collision Avoidance: Smart spacing with 70% effective area usage

Performance Optimization

• Matplotlib Backend: High-quality vector graphics
• Memory Efficient: Local processing without external APIs
• Fast Rendering: Optimized for complex flowcharts

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Support

If you encounter any issues or have questions:

1. 📖 Check the documentation
2. 🔍 Search existing issues on GitHub
3. 🆕 Create a new issue with detailed description
4. 💬 Join our community discussions
5. 📧 Email: [email protected]

🙏 Acknowledgments

• Matplotlib team for the excellent plotting library
• Mermaid.js community for inspiration
• Dify platform for the plugin framework