RadarTopicsBuildersWeeklyReads
Open Source Radar
yizhiyanhua-ai/

fireworks-tech-graph

GitHubWebsite

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.

9.7kstars
805forks
0issues
MITlicense
2026since
Star historydaily snapshots by VibeCrowd

Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).

Alternatives & relatedmatched by topic overlap
Reviewgenerated from repository data · Aug 5, 2026

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
SharePost on XLinkedIn
All trending reposRevenue-verified startups →