Generates SVG/PNG diagrams from natural language with 12 visual styles, UML support, and AI/Agent workflow patterns. Provides a unified CLI, SVG validation, and offline HTML exports.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
fireworks-tech-graph is a Python-based agent skill that converts natural language descriptions into geometry-checked SVG diagrams, high-resolution PNGs, validated SVG-to-GIF motion, and offline interactive HTML. It ships with 12 visual styles (11 generator-backed + 1 AI-authored) and supports 14 diagram types including full UML support. It offers an executable style system and a unified CLI for rendering, validating, inspecting, and exporting diagrams.
How it works
The project uses a looped pipeline to produce verified diagrams: Prompt → Diagram Contract → Semantic IR → Style Spec → Route Planner → SVG Build → Structural Validation → PNG Visual Readback → Targeted Revision → Verified SVG + PNG. It enforces deterministic checks (XML structure, marker integrity, path geometry) and perceptual validation via a PNG readback, followed by targeted corrections within a bounded number of passes. It outputs a validated SVG and a PNG, with an offline HTML export and a focused SVG-to-GIF motion path.
Getting started
Installation
npx -y skills@1.5.17 add \
yizhiyanhua-ai/fireworks-tech-graph/skills/fireworks-tech-graph \
--agent codex claude-code -g -y --copy
This creates complete copies at ~/.agents/skills/fireworks-tech-graph for Codex and ~/.claude/skills/fireworks-tech-graph for Claude Code, including scripts, schemas, fixtures, templates, tests, references, and metadata.
mkdir -p ~/.agents/skills
git clone https://github.com/yizhiyanhua-ai/fireworks-tech-graph.git ~/.agents/skills/fireworks-tech-graph
CLI usage (examples)
python3 "$SKILL_ROOT/scripts/fireworks.py" doctor
python3 "$SKILL_ROOT/scripts/fireworks.py" validate architecture "$SKILL_ROOT/fixtures/api-flow-style7.json"
python3 "$SKILL_ROOT/scripts/fireworks.py" render architecture "$SKILL_ROOT/fixtures/api-flow-style7.json" diagram.svg --report layout.json
python3 "$SKILL_ROOT/scripts/fireworks.py" check diagram.svg
python3 "$SKILL_ROOT/scripts/fireworks.py" export-html diagram.svg diagram.html --title "Agent Runtime Architecture"
python3 "$SKILL_ROOT/scripts/fireworks.py" animate diagram.svg diagram.gif
The HTML export is one offline file and includes pan/zoom and themes.
Recent releases
- v1.2.0 Fireworks Tech Graph v1.2.0 (2026-07-17): production-validated SVG-to-GIF workflow while preserving twelve diagram styles.
- v1.1.0 Fireworks Tech Graph v1.1.0 (2026-07-15): engineering-grade diagram system while preserving all 12 styles.
- v1.0.5 Fireworks Tech Graph v1.0.5 (2026-07-17): Skill usable by Codex and Claude Code.
- v1.0.4 Fireworks Tech Graph v1.0.4 (2026-07-17): deterministic update path documentation.
- v1.0.3 Fireworks Tech Graph v1.0.3 (2026-07-17): installation source explicit and separate agent skill installer path.
Traction
Not provided in this summary.
License
MIT
Details
- Language: Python
- Repository created: 2026-04-10
- Last push: 2026-07-17
- Stars: 9667; Forks: 805; Open issues: 0
- Topics: agent-workflows, ai, claude-code, developer-tools, diagrams, svg






