Guia de Instalação

O animaflow pode ser instalado de forma modular dependendo do caso de uso e dos motores de renderização desejados.

Instalação via pip

1. Pacote Básico (Core + Web Canvas)

Para criar fluxos, rodar layouts e exportar visualizações interativas em HTML/SVG independente:

pip install animaflow

2. Com suporte ao Renderizador Manim (Vídeo & GIF)

Para gerar animações em vídeo MP4 e GIFs em alta definição para LinkedIn, YouTube ou apresentações:

pip install "animaflow[manim]"

3. Todos os Renderizadores Opcionais

Instala o core e o renderizador de vídeo Manim. A exportação Web Canvas usa apenas recursos incluídos no pacote básico:

pip install "animaflow[all]"

4. Ferramentas de Desenvolvimento e Publicação

Instala pytest, Ruff, mypy, build e twine:

pip install -e ".[dev]"

Dependências de Sistema

FFmpeg (Obrigatório para o Manim)

Para compilar vídeos e extrair GIFs através do Manim Community Edition, o binário do ffmpeg precisa estar presente no seu PATH:

=== "Ubuntu / Debian"

sudo apt update
sudo apt install ffmpeg

=== "macOS (Homebrew)"

brew install ffmpeg

=== "Windows (Winget / Chocolatey)"

winget install Gyan.FFmpeg
# ou com chocolatey:
choco install ffmpeg

Verificando a Instalação

Abra um terminal interativo Python e execute:

import animaflow as af

flow = af.Flow(title="Teste de Instalação")
node = flow.add_node("API Gateway")
print(f"animaflow instalado com sucesso! Nó criado: {node.name}")

Se o comando executar sem erros, sua instalação está pronta para o Primeiro Diagrama!