fireworks-tech-graph
Turns plain-language descriptions into SVG and PNG technical diagrams, with 12 visual styles.
- Stars
- 11.9k
- Forks
- 934
- Licence
- MIT
- Language
- Python
- Last update
- 16 days ago
- Type
- AI model / agent
What it is
fireworks-tech-graph is an Agent Skill that works in Codex and Claude Code. You describe a system in English or Chinese, and it generates SVG diagrams, high-resolution PNG exports, short GIF animations of diagram flows, and offline interactive HTML diagrams. The README says it supports UML diagram types and AI/agent workflow patterns, so it is aimed at people who need architecture or flow diagrams without drawing them by hand.
- Generate a memory architecture diagram for an AI agent system in a chosen visual style
- Produce a C4 container diagram for a checkout service review
- Export a 1920px PNG of a generated SVG diagram using the included CLI
- Create a short animated GIF showing request flow through a generated semantic SVG
Great for
- Developers who want architecture or flow diagrams from a text description inside Claude Code or Codex
- Engineers preparing C4, cloud deployment, or reliability review diagrams
- People documenting AI agent or memory architectures
- Teams that want consistent diagram styles across documentation
Not ideal for
- Anyone who needs a pure drag-and-drop diagram editor, since the README describes generating diagrams from natural language rather than an interactive editing UI
- Users who do not use Claude Code or Codex, since the README frames it as an Agent Skill for those tools
- People who need guaranteed pixel-perfect layout without reviewing output, since the README notes measurement limits for text fit
How to get it
- 1
See the README
You'll need: Python 3 · Claude Code or Codex
Clone the repository
git clone https://github.com/yizhiyanhua-ai/fireworks-tech-graph - 2
Run it
- Install the Skill into Claude Code or Codex following the repository instructions
- Run the version command to confirm the package and Skill root are detected
- Describe a diagram in natural language and ask for a specific style
- Export the resulting SVG to PNG with the export-png command
- 3
Get the most out of it
- Use the text_policy strict option to reject visible truncation before output is written
- Run the doctor command to see which optional PNG or GIF dependencies are missing
- Pick one of the 12 documented styles that matches your audience
- Use the browser PNG exporter when you need Chromium-level rendering fidelity
Downloads
Strengths
- Works with both Codex and Claude Code as a single Skill, according to the README
- Offers 12 visual styles and 14 UML diagram types as described in the README
- Released under the MIT license, which permits free use and modification
Trade-offs
- The README is truncated and does not fully document setup, so some details are unclear
- Text-fit and layout quality depend on the generator, and the README notes measurement limits
- Documentation is partly in Chinese and English with some sections that assume familiarity with Agent Skills
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| fireworks-tech-graph (this) | 11.9k | AI model / agent | intermediate | 16 days ago | Developers who want architecture or flow diagrams from a text description inside Claude Code or Codex |
| mermaid | 91k | Dev tool | beginner | 4 days ago | Developers who want diagrams stored as text alongside their code and docs |
| excalidraw | 135k | App | beginner | 5 days ago | Teams sketching diagrams or wireframes together in a shared canvas |
| diagram-design | 64.2k | AI model / agent | beginner | 5 days ago | Developers who already use a supported coding agent and want architecture or flow diagrams without learning a diagram language |
| ponytail | 182k | AI model / agent | beginner | 8 days ago | Developers who use Claude Code or similar AI agents and find the generated code too long |
| ECC | 295k | Dev tool | intermediate | 4 days ago | Developers who already use Claude Code and want a shared workflow for planning, testing and review |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.