O que é fireworks-tech-graph?
O fireworks-tech-graph é uma Agent Skill, um SKILL.md mais scripts Python, que permite ao Claude Code ou ao Codex desenhar diagramas técnicos a partir de uma descrição em inglês ou chinês simples. O agente classifica o pedido, escreve uma descrição versionada do diagrama em JSON, e o gerador incluído roteia as setas e renderiza SVG, um PNG de 1.920 pixels, uma página HTML interativa offline ou um GIF animado.
Ele cobre 14 tipos de diagrama, incluindo o conjunto UML (classe, sequência, máquina de estados, implantação e outros) e diagramas ER, além de padrões prontos para sistemas de IA, como RAG, configurações multiagente, fluxos de chamadas de ferramentas e memória no estilo Mem0. Há 12 estilos visuais, 11 conduzidos pelo gerador e um escrito livremente pelo modelo, e ícones para mais de 40 produtos.
Tem licença MIT, é escrito principalmente em Python, por Brad Zhang (yizhiyanhua-ai). A versão 1.2.0 saiu em 17 de julho de 2026; a última mudança de código entrou em 5 de setembro, e o repositório tinha cerca de 11.800 estrelas na última verificação.
fireworks-tech-graph vale a pena?
O fireworks-tech-graph vale a instalação por um motivo: ele não confia no primeiro desenho do modelo. A skill faz o agente escrever uma descrição intermediária validada por schema, um planejador determinístico roteia as arestas, e o resultado precisa passar por verificações estruturais (XML, marcadores, sobreposições, cruzamentos) antes que o agente leia de volta o PNG e faça no máximo duas correções pontuais. O contrato de vitrine exige zero cruzamentos, no máximo duas curvas por aresta e pelo menos 40 pixels entre os nós. Quando o agente não consegue ler imagens, ele informa `visual_review: skipped` em vez de alegar aprovação.
A saída é voltada a slides, posts de blog e revisões de design, não a documentação viva. Os diagramas saem como SVG e PNG, que ficam muito melhores que o Mermaid, mas não podem ser comparados em diff nem editados como texto em um pull request. O estilo 9 produz revisões de contêineres C4, e os estilos 10 a 12 cobrem implantações multirregião, topologias de eventos e painéis de golden signals, o que está mais perto do que as equipes de plataforma realmente desenham. Dois dos estilos imitam o visual da casa do Claude e da OpenAI, o que serve para apresentações internas e é questionável em uma página pública.
A instalação tem arestas. O README avisa que um `npx skills add` simples do repositório pode pegar o SKILL.md errado, então você precisa informar o caminho aninhado, e o pacote npm (1.0.4) está atrás da release do GitHub. A exportação em PNG precisa de cairosvg ou rsvg-convert, e os GIFs precisam de FFmpeg, Chrome e Puppeteer instalados ao lado de cada cópia da skill.
A manutenção é de uma pessoa. Há 12 colaboradores, uma issue aberta, e o único commit desde 5 de setembro é uma edição de patrocínio no README; o README também anuncia a consultoria paga do autor. Comparada ao Anatomy, que constrói uma única figura explicativa interativa ao longo de uma sessão longa, esta skill é mais rápida e mais convencional: caixas, setas e raias, bem feitas.
Onde ele se destaca
Um staff engineer preparando uma revisão de design
Desenhar a arquitetura de checkout proposta sem passar uma tarde no draw.io
Peça ao Claude Code um diagrama de contêineres C4 no estilo 9, com serviços e protocolos nomeados; a skill renderiza SVG e PNG e informa os resultados da validação. O custo é uma sessão do agente; editar significa pedir de novo, não arrastar caixas.
Um developer advocate em uma empresa de infraestrutura de IA
Ilustrar um pipeline de RAG ou multiagente para um post de lançamento
Use o padrão embutido de RAG ou multiagente com ícones de produtos e exporte um PNG de 1.920 pixels mais um GIF animado para redes sociais. O caminho do GIF exige FFmpeg e Puppeteer instalados antes.
Um líder de SRE documentando um sistema orientado a eventos
Mostrar tópicos, consumidores e filas de mensagens mortas em uma única imagem
O estilo 11 desenha os tópicos como trilhos e os processadores como estações, com uma DLQ declarada; a exportação em HTML offline dá aos leitores pan e zoom sem hospedar nada.
Antes de decidir
- Configuração
- `npx -y skills@1.5.17 add yizhiyanhua-ai/fireworks-tech-graph/skills/fireworks-tech-graph --agent codex claude-code -g -y --copy`, ou um git clone em ~/.claude/skills ou ~/.agents/skills. Precisa de Python 3.9+ e cairosvg; `fireworks.py doctor` verifica as dependências opcionais de GIF.
- Integrações
- Claude Code e Codex pelo formato Agent Skills; uma CLI unificada (render, validate, check, export-html, animate) que também funciona sem agente; renderiza com cairosvg, rsvg-convert ou Chrome headless.
- Dados e privacidade
- O README não descreve nenhum serviço hospedado: renderização e verificações rodam localmente, e a descrição que você digita só vai para o modelo que o seu agente usa. Licença MIT, então o uso comercial é irrestrito.
- Custo em escala
- Gratuito. O custo são os tokens do agente, incluindo até duas rodadas de correção e uma leitura de volta da imagem por diagrama; não há números de tokens por diagrama publicados.
- Limites
- Sem fonte de diagrama em texto para fluxos de docs-as-code; o estilo 8 é escrito livremente pelo modelo e dispensa o gerador; o rsvg-convert pode descartar CSS, então os PNGs ficam melhores com o cairosvg.
O que é bom
- Validador e leitura de volta do PNG antes que um diagrama seja dado como pronto
- 14 tipos de diagrama, incluindo UML completa e ER
- Padrões para sistemas de IA (RAG, multiagente, chamadas de ferramentas) embutidos
- Saídas em SVG, PNG, HTML offline e GIF
O que não é
- Saída em imagem, não texto que você possa comparar em diff em um pull request
- Exige caminho de instalação aninhado; o pacote npm está atrasado
- A exportação em GIF precisa de FFmpeg, Chrome e Puppeteer
- Um único mantenedor; pouca mudança de código desde setembro
Ideal para
Engenheiros e redatores técnicos que precisam de diagramas de arquitetura caprichados para slides, posts e revisões de design a partir do Claude Code ou do Codex.
Alternativas ao fireworks-tech-graph
fireworks-tech-graph: perguntas frequentes
- fireworks-tech-graph vale a pena?
- Uma skill de diagramas que confere a própria geometria antes de entregar, ideal para slides e posts, embora o Mermaid ainda vença nos diagramas que vivem na documentação. Damos nota 3.9 de 5.
- Quanto custa fireworks-tech-graph?
- Gratuito e de código aberto (MIT). Roda com a assinatura de agente ou a API que você já usa.
- Quais são as desvantagens de fireworks-tech-graph?
- Saída em imagem, não texto que você possa comparar em diff em um pull request; exige caminho de instalação aninhado; o pacote npm está atrasado; a exportação em GIF precisa de FFmpeg, Chrome e Puppeteer; um único mantenedor; pouca mudança de código desde setembro.
- Para quem fireworks-tech-graph é indicado?
- Engenheiros e redatores técnicos que precisam de diagramas de arquitetura caprichados para slides, posts e revisões de design a partir do Claude Code ou do Codex.
- Quanto custa fireworks-tech-graph para uma equipe ou em produção?
- Gratuito. O custo são os tokens do agente, incluindo até duas rodadas de correção e uma leitura de volta da imagem por diagrama; não há números de tokens por diagrama publicados.
- fireworks-tech-graph é seguro para dados da empresa?
- O README não descreve nenhum serviço hospedado: renderização e verificações rodam localmente, e a descrição que você digita só vai para o modelo que o seu agente usa. Licença MIT, então o uso comercial é irrestrito.
- Quais são as melhores alternativas ao fireworks-tech-graph?
- As alternativas mais próximas que analisamos são Anatomy, Anthropic Skills e Impeccable.
Respostas verificadas em 26 de out. de 2026.