Repolode
mingrammer

mingrammer/diagrams

Diagrama como código: crie diagramas de arquitetura de nuvem e sistemas com Python, usando ícones de AWS, Azure, GCP, Kubernetes e muito mais.

Alternativa open source a:LucidchartMicrosoft Visio

Estrelas
42,752
Forks
2,733
Issues abertas
400
Último commit
há 5 dias

O que é?

Diagrams é uma biblioteca Python para criar diagramas de arquitetura de sistemas em nuvem como código. Em vez de arrastar formas em uma ferramenta de design, você descreve os nós e as conexões entre eles em um script Python, e a biblioteca renderiza o resultado com Graphviz. Como o diagrama é código puro, ele pode ser versionado em qualquer sistema de controle de versão e atualizado junto com a infraestrutura que representa.

A biblioteca inclui conjuntos de ícones dos principais provedores de nuvem, como AWS, Azure, Google Cloud, Kubernetes, Alibaba Cloud e Oracle Cloud, além de nós para sistemas on-premises, produtos SaaS, frameworks de programação e elementos do modelo C4. Ela é voltada à prototipagem de novas arquiteturas ou à documentação das já existentes. Não se conecta a recursos reais de nuvem nem os gerencia, e não gera código de CloudFormation ou Terraform.

Um playground online permite testar a biblioteca no navegador sem instalar Python ou Graphviz.

Recursos principais

  • 01Defina diagramas de arquitetura como código Python, que pode ser versionado com git.
  • 02Inclui conjuntos de ícones para AWS, Azure, GCP, Kubernetes, Alibaba Cloud, Oracle Cloud e muito mais.
  • 03Oferece suporte a tipos de nós para on-premises, SaaS, programação e C4.
  • 04Renderiza a saída usando Graphviz.
  • 05Disponibiliza um playground online que funciona no navegador.

Casos de uso

  • Prototipar uma nova arquitetura de sistemas em nuvem antes da implementação.
  • Documentar uma implantação existente de nuvem ou Kubernetes com diagramas mantidos junto com o código.
  • Gerar diagramas de arquitetura em pipelines de documentação.

Início rápido

  1. 1

    Instale o Graphviz (no macOS, usando o Homebrew)

    brew install graphviz
  2. 2

    Instale o pacote diagrams com pip

    pip install diagrams

Antes de usar

  • É necessário instalar o Graphviz separadamente para renderizar diagramas.
  • Requer Python 3.9 ou superior.
  • Não controla recursos na nuvem nem gera código de Terraform ou CloudFormation; apenas desenha diagramas.

Tópicos

Perguntas frequentes

O que é diagrams?
Diagrama como código: crie diagramas de arquitetura de nuvem e sistemas com Python, usando ícones de AWS, Azure, GCP, Kubernetes e muito mais. Diagrams é uma biblioteca Python para criar diagramas de arquitetura de sistemas em nuvem como código. Em vez de arrastar formas em uma ferramenta de design, você descreve os nós e as conexões entre eles em um script Python, e a biblioteca renderiza o resultado com Graphviz. Como o diagrama é código puro, ele pode ser versionado em qualquer sistema de controle de versão e atualizado junto com a infraestrutura que representa.
diagrams é gratuito? Qual é a licença?
diagrams é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
diagrams ainda é mantido?
Manutenção ativa. O último commit de diagrams foi em 17 de out. de 2026.
Para que posso usar diagrams?
Prototipar uma nova arquitetura de sistemas em nuvem antes da implementação. Documentar uma implantação existente de nuvem ou Kubernetes com diagramas mantidos junto com o código. Gerar diagramas de arquitetura em pipelines de documentação.
Como instalar diagrams?
Instale o Graphviz (no macOS, usando o Homebrew): brew install graphviz Instale o pacote diagrams com pip: pip install diagrams
Onde consigo diagrams?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mingrammer/diagrams

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados