This project provides a Next.js web application that integrates AI capabilities with draw.io diagrams, enabling users to create, modify, and enhance diagrams using natural language commands. It targets developers and power users seeking an intuitive, AI-assisted approach to diagramming, offering benefits like streamlined creation and real-time interactive refinement.

How It Works

The application leverages Next.js for its frontend framework, @ai-sdk/react for AI interactions and chat interfaces, and react-drawio for diagram manipulation. Diagrams are represented as XML, which the AI processes based on natural language commands to generate or modify the diagram structure. This approach allows for AI-driven diagram creation, replication from images, and intelligent editing directly through text prompts, with a focus on precise XML manipulation for efficiency.

Quick Start & Requirements

• Installation: Clone the repository (git clone https://github.com/DayuanJiang/next-ai-draw-io), navigate into the directory, and run npm install or yarn install.
• Prerequisites: A .env.local file is required in the root directory, populated with API keys for at least one AI provider (OpenAI, Google, or OpenRouter).
• Running: Execute npm run dev to start the development server.
• Links: Demo site available at https://next-ai-draw-io.vercel.app/. Deployment is straightforward using Vercel.

Highlighted Details

• LLM-Powered Diagram Creation: Generate and manipulate draw.io diagrams using natural language commands.
• Image-Based Diagram Replication: Upload images or existing diagrams for AI replication and enhancement.
• Diagram History: Comprehensive version control to track and restore diagram states.
• Interactive Chat Interface: Real-time communication with AI for diagram refinement.
• Smart & Targeted XML Editing: Modify diagrams via text prompts, with AI performing precise edits directly on the XML structure.
• Improved XML Handling: Automatic formatting of XML for enhanced compatibility.

Maintenance & Community

Support and inquiries can be directed by opening an issue on the GitHub repository or contacting the maintainer via email at me[at]jiang.jp. No specific community channels (e.g., Discord, Slack) are mentioned.

Licensing & Compatibility

This project is licensed under the MIT License, which permits broad use, including commercial applications and linking within closed-source projects.

Limitations & Caveats

The project is under active development, with noted TODOs indicating ongoing work on improving AI XML modification capabilities and the smoothness of shape streaming updates, suggesting potential areas for future enhancement or current instability.