weike-zhang/architecture-canvas

O que é?

Recursos principais

• 01Gera diagramas de arquitetura a partir de documentos, planilhas, PDFs e imagens enviados, por meio de chat.
• 02Canvas editável do Excalidraw com recursos para arrastar, editar textos, desfazer e importar.
• 03Exporta diagramas como SVG, PNG e arquivos editáveis que incluem imagens.
• 04Revisa as alterações propostas antes de aplicá-las e permite fixar componentes selecionados.
• 05Roda localmente em 127.0.0.1, com dados de cada sessão armazenados em uma pasta do workspace.
• 06Oferece um SDK para Python e um servidor MCP stdio para incorporar o renderizador e o leitor de documentos.

Casos de uso

• Transformar um documento de requisitos em um primeiro rascunho de diagrama de arquitetura de sistema.
• Refinar um diagrama existente por meio de uma conversa, mantendo o layout manual.
• Criar diagramas de arquitetura editáveis a partir de arquivos locais, sem enviá-los a um editor hospedado.
• Adicionar ferramentas de leitura de documentos e renderização de diagramas a um agente de IA via MCP.

Início rápido

1. 1

   Clone o repositório

   git clone https://github.com/weike-zhang/architecture-canvas.git
2. 2

   Acesse o diretório do projeto

   cd architecture-canvas
3. 3

   Inicie o app (na primeira execução, as dependências serão instaladas e a página será compilada)

   python3 start.py
4. 4

   Abra o workspace no navegador e configure um modelo em Configurações do modelo

Antes de usar

• !Versão alfa que funciona apenas localmente, vinculada a 127.0.0.1 e sem contas multiusuário.
• !Chat, compreensão de documentos e geração de diagramas exigem um serviço de modelos com uma chave de API que ofereça suporte a tool calling.
• !A geração é limitada a cerca de 22 componentes e não abrange diagramas de sequência, ER ou com ramificações complexas.

Tópicos

Perguntas frequentes

O que é architecture-canvas?

Workspace web local-first para conversar com documentos enviados e criar e refinar diagramas de arquitetura editáveis em um canvas do Excalidraw. Architecture Canvas permite enviar documentos de requisitos, planilhas, PDFs e imagens e, em seguida, conversar sobre eles com um assistente de IA que cria um rascunho de diagrama de arquitetura. O diagrama fica em um canvas editável do Excalidraw, onde você pode arrastar nós, editar textos e exportar em SVG ou PNG depois que o modelo gerar uma primeira versão.

architecture-canvas é gratuito? Qual é a licença?

architecture-canvas é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

architecture-canvas ainda é mantido?

Manutenção ativa. O último commit de architecture-canvas foi em 3 de out. de 2026.

Para que posso usar architecture-canvas?

Transformar um documento de requisitos em um primeiro rascunho de diagrama de arquitetura de sistema. Refinar um diagrama existente por meio de uma conversa, mantendo o layout manual. Criar diagramas de arquitetura editáveis a partir de arquivos locais, sem enviá-los a um editor hospedado. Adicionar ferramentas de leitura de documentos e renderização de diagramas a um agente de IA via MCP.

Como instalar architecture-canvas?

Clone o repositório: git clone https://github.com/weike-zhang/architecture-canvas.git Acesse o diretório do projeto: cd architecture-canvas Inicie o app (na primeira execução, as dependências serão instaladas e a página será compilada): python3 start.py Abra o workspace no navegador e configure um modelo em Configurações do modelo

Onde consigo architecture-canvas?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/weike-zhang/architecture-canvas