animaflow 0.1.1

Diagramas e fluxogramas de arquitetura declarativos, animados e programáveis em Python
_{Modele fluxos uma vez e exporte para HTML/SVG interativo ou animações com Manim}

Galeria & Exemplos

Streaming Contínuo — fluxo em tempo real de partículas	Multi-Agent Swarm — DAG de orquestração em camadas	RAG Pipeline — arquitetura de busca e LLM

Por que o animaflow?

Criar diagramas de arquitetura de software para redes profissionais (LinkedIn, X/Twitter), vídeos técnicos (YouTube, Reels) e apresentações corporativas geralmente exige:

• Escrever centenas de linhas manuais de geometria, coordenadas absolutas e updaters no Manim ou After Effects, ou
• Usar geradores estáticos (Graphviz, PlantUML, Diagrams) sem qualquer suporte a movimento, ritmo narrativo ou pulso de dados.

O animaflow resolve isso separando a definição semântica do fluxo dos motores de renderização:

1. Declare Nós e Conexões: especifique nós, serviços, banco de dados, labels e metadados via DSL simples em Python.
2. Auto-Layout Inteligente: organize automaticamente nós em camadas (DAGs), colunas ou sequências horizontais/verticais com alinhamento e margens dinâmicas anti-sobreposição.
3. Timeline Narrativa: anime pacotes individuais, streams contínuos de partículas, transições de estado e realces de nós de forma declarativa.
4. Múltiplos Backends: exporte diretamente para Manim CE (vídeos MP4 e GIFs em alta definição) e HTML/Web Canvas interativo.

Como funciona a arquitetura

O núcleo do animaflow é modular e extensível:

Instalação

pip install animaflow

Para renderizar animações com Manim:

pip install "animaflow[manim]"

A renderização de vídeo com Manim também requer FFmpeg instalado no sistema.

Exemplo rápido

import animaflow as af

flow = af.Flow(title="Pipeline de pedidos")
api = flow.add_node("API", subtitle="Recebe pedidos")
worker = flow.add_node("Worker", subtitle="Processa eventos")
database = flow.add_node("Database", subtitle="Armazena resultados")

flow.connect(api, worker, label="evento")
flow.connect(worker, database, label="persistência")
flow.auto_layout(mode="horizontal")
flow.timeline.reveal_sequence(delay_per_item=0.3)
flow.export_html("pipeline.html")

O arquivo pipeline.html pode ser aberto diretamente em um navegador.

Exemplos Prontos

Os scripts de demonstração e seus comandos de execução estão na pasta de exemplos do GitHub.

Licença

Distribuído sob a licença MIT. Consulte o arquivo de licença.