Summary

Visiomaster is a toolkit for reconstructing diagrams (flowcharts, architecture, paper modules) from images into editable Microsoft Visio .vsdx files, also exporting .svg/.png. It targets engineers and researchers needing to transform static visuals into modifiable documents, enabling integration and further editing.

How It Works

The project analyzes images using an understanding pipeline, decomposing structures and styles into an intermediate scene.json description. This data drives Visio COM automation for rendering editable .vsdx files. A key feature is its iterative refinement process, incorporating visual review loops comparing original images against rendered replicas, and using structured feedback to guide regeneration.

Quick Start & Requirements

Requires Windows, Microsoft Visio desktop, and Python 3.10+. Installation: python -m pip install -r requirements.txt. An environment check script is available. Usage includes CLI interaction or as an AI assistant skill. A paid online service offers an alternative to local setup.

Highlighted Details

• Iterative Replication Workflow: Focuses on refining replication after failures, including image staging, review bundle generation, and converting visual findings into repair plans.
• Arrow Plan Gate: Enhances accuracy by recording arrow metadata and binding scene edges to specific arrow facts for correct topology.
• Rounded Orthogonal Connectors: Supports visually appealing, right-angled connectors with rounded corners.
• Strict Replication Process: Outlines a detailed workflow for complex diagrams, emphasizing visual review of original vs. replica images, with scripts acting as auxiliary gates.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels (e.g., Discord, Slack).

Licensing & Compatibility

A LICENSE file is present but its terms are not specified in the README. Compatibility is primarily for Windows with Microsoft Visio desktop and pywin32. Variations across Office/Visio versions, system languages, and fonts may require debugging.

Limitations & Caveats

Rendering requires Windows and Microsoft Visio desktop; macOS/Linux cannot render .vsdx. image_to_scene.py provides a starting point, not perfect replication; 1:1 fidelity needs LLM/human oversight. Environment variations may introduce compatibility issues.