Communitygithub.com

manim

Renderize animações explicativas e diagramas estáticos com Manim Community. Use quando um visual explicar algo melhor que texto (matemática, equações, gráficos de funções, geometria, grafos/redes, tabelas, matrizes, 3D, campos vetoriais), ou quando o usuário pedir uma animação, diagrama ou cena Manim.

O que é manim?

Esta skill permite que um agente de IA crie animações explicativas e diagramas estáticos utilizando a biblioteca Manim Community v0.22.1. É ideal para transformar conceitos abstratos – como expressões matemáticas, gráficos de funções, geometria, grafos, tabelas, matrizes, cenas 3D e campos vetoriais – em conteúdo visual dinâmico e memorável. A skill suporta a geração de saídas em PNG (para figuras estáticas), MP4 (para animações com narração e legendas) e GIF. Ela oferece um fluxo de trabalho completo: desde a escolha do exemplo mais próximo no repositório de referências, passando pela escrita da cena em Python (com suporte a ícones prontos e mixins para controle de tempo de leitura e narração por voz neural), até a renderização final e entrega do arquivo. A skill é compatível com plataformas que exibem Markdown com mídia embutida (como T3 Code) e também com terminais de texto simples. Toda iteração de ajuste na cena termina com uma nova renderização e entrega do resultado final.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/logan-gatlin/manim-skill/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

título

Documentação

O que manim faz?

Instalado aqui: Manim Community v0.22.1 (manim no PATH, instalado como uv tool com o extra typst), além de TeX Live e dvisvgm para Tex/MathTex, e Chatterbox Turbo para narração (instalação para CPU em seu próprio venv em ~/.local/opt/chatterbox, controlado por narration.py). Os arquivos de cena são executados no próprio Python da ferramenta, que inclui numpy, scipy e networkx; outras importações falham. Use apenas a API do ManimCE. O manimgl do 3Blue1Brown é uma biblioteca diferente, então o código escrito para ele não funcionará aqui.

Estilo

Manim é uma ferramenta para apresentar informações de forma dinâmica e interessante. Se o que você fez poderia ter sido facilmente feito como um fluxograma, planilha, grafo de pontos ou apresentação de slides, você não está usando o manim corretamente. O belo é mais envolvente e mais memorável. Evite jargões técnicos; mantenha sua apresentação acessível. Escolha um conjunto de motivos visuais e mantenha-se fiel a eles – um conceito deve ter uma representação visual consistente. Conte uma história, comece no meio da ação. Apresente ideias e problemas a partir dos primeiros princípios.

Passos

  1. Escolha a saída. Use um PNG estático para uma imagem fixa (um diagrama legendado, gráfico, tabela ou fórmula). Use um MP4 quando o ponto for mudança ou sequência (uma derivação passo a passo, um ponto em movimento, uma transformação). Use GIF apenas quando o local de destino não puder reproduzir vídeo.

  2. Encontre os exemplos mais próximos. Abra o(s) arquivo(s) de tópico abaixo, examine o índice no topo e leia os 1–3 exemplos mais próximos do que você precisa. Construa sua cena adaptando-os: o uso da API deles é conhecido por funcionar nesta versão.

  3. Escreva a cena em /tmp/manim/<slug>/scene.py, a menos que o usuário tenha nomeado um local. Comece com from manim import * e defina uma subclasse de Scene (MovingCameraScene / ThreeDScene / ZoomedScene quando os exemplos usarem uma).

    Toda imagem de uma coisa (uma nuvem, um servidor, um cadeado, uma bandeira, uma pessoa, um documento) é um ícone da biblioteca desta skill, usado como está: copie icons.py ao lado da cena, encontre um ID com grep -iw <palavra> assets/index.tsv no diretório desta skill (tente um sinônimo quando uma palavra não encontrar nada), e carregue-o com icon(id, color=..., height=...). tabler/outline/* e tabler/filled/* são ícones de linha e sólidos monocromáticos (Tabler Icons) desenhados em color; fluent/* são emojis coloridos (Fluent Emoji, estilo Flat) que mantêm suas próprias cores. Desenhe apenas a estrutura do diagrama você mesmo, com as formas do Manim: caixas, setas, linhas, eixos, gráficos e rótulos. Dê a cada conceito um ícone e reuse-o, como um dos motivos.

    Um MP4 ou GIF que mostra texto deve dar aos espectadores tempo de leitura, e um verificador o aplica. Copie reading_time.py ao lado da cena, importe-o com from reading_time import ReadingTime e coloque o mixin antes da classe base da cena: class SceneName(ReadingTime, Scene). Chame self.wait_to_read() antes de cada play que esconde, substitui ou escurece texto. Ele espera até que cada texto visível esteja na tela por 1 s mais suas palavras a 150 palavras por minuto, com todo o texto revelado por um play lido em conjunto. Mostre novas palavras como um novo mobject (FadeIn, ReplacementTransform) em vez de usar become(), para que seu tempo comece do zero. A animação pode continuar durante a espera: coloque self.wait_to_read() após uma animação que é reproduzida enquanto o texto está visível.

    Um MP4 que explica com legendas também é narrado: uma voz as lê em voz alta. Copie narration.py ao lado da cena e coloque-o antes de ReadingTime: class SceneName(Narration, ReadingTime, Scene). self.speak(texto) espera a linha anterior terminar, então inicia a próxima, e as animações que se seguem são reproduzidas enquanto ela é falada. Coloque-o logo antes do play que mostra a legenda que ele lê. A legenda mostra a linha falada palavra por palavra, e toda linha falada tem uma: escreva cada linha uma vez e passe essa mesma string para speak e para o Text da legenda. Quando a voz precisar de uma reescrita que a tela não mostra ("vinte" para "20"), coloque-a no dicionário pronounce da cena, que muda apenas o que é falado. Em uma cena narrada, a voz define a espera em vez da contagem de palavras: o texto que aparece enquanto uma linha é falada deve permanecer até que o narrador termine mais uma pausa de 0,5 s, e self.wait_to_read() espera exatamente esse tempo antes da próxima mudança (texto mostrado durante o silêncio mantém a regra da contagem de palavras). A voz é um clone neural de um narrador masculino calmo (Chatterbox Turbo), ajustado para percorrer diagramas técnicos. Cada nova linha leva cerca de 1–3× seu comprimento falado para sintetizar (incluindo imagens estáticas de rascunho) e é armazenada em cache em media/voice, para que renderizações posteriores apenas vocalizem as linhas que você alterou. Escreva cada linha para ser ouvida, não lida. Siglas como API, TLS e HTTP são lidas bem como escritas, e narration.py já soletra unidades após números (200 ms), versões pontuadas (2.4.1) e k8s. Diga outras strings de máquina como um narrador diria, novamente através de pronounce: "dezessete onze", não "2026.11.1711". Descreva caminhos e nomes de branch em vez de lê-los em voz alta ("um branch de release de correções automáticas") e corrija qualquer palavra que a voz erre através do dicionário pronounce da cena ({"edgeworker": "edge worker"}).

    Todo MP4 ou GIF termina em um cartão de crédito nomeando o modelo que o criou. Copie produced_by.py ao lado da cena, coloque o mixin primeiro de todos: class SceneName(ProducedBy, Narration, ReadingTime, Scene) (ou class SceneName(ProducedBy, Scene) para uma cena sem texto), e defina produced_by com o nome do seu modelo conforme seu prompt de sistema fornece (produced_by = "Claude Opus 5.5"). Se suas instruções não nomearem seu modelo, pergunte ao usuário. Quando a cena, sua narração e sua verificação de tempo de leitura terminarem, o mixin esmaece a cena e mantém o cartão pelos últimos 0,5 s. Imagens estáticas o ignoram.

  4. Rascunho e verificação. Renderize uma imagem estática de baixa qualidade e leia o PNG:

    cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py SceneName
    # -> media/images/scene/draft.png
    

    Para uma animação, verifique também os momentos-chave: -s -n 0,K para após a animação K (base 0; cada self.play e cada self.wait conta como um) e salva esse quadro. O quadro tem aproximadamente 14,2 × 8 unidades, centrado na origem. Corrija e re-renderize até que cada quadro verificado mostre todos os elementos dentro do quadro, sem rótulos sobrepostos e texto legível.

    Uma cena que retira o texto muito cedo falha com ReadingTimeError, que lista cada texto, quando apareceu e por quanto tempo foi mostrado versus quanto tempo precisava. Adicione self.wait_to_read() antes de cada mudança listada. Para visualizar quadros de rascunho antes que o tempo seja corrigido, prefixe o comando com MANIM_READING_TIME=warn. A renderização final é executada sem ele e deve passar.

  5. Renderização final. Use -qm (720p30). Cenas 3D são lentas no renderizador Cairo, então faça o rascunho delas em -ql.

    manim render -qh --media_dir media -o final scene.py SceneName
    # -> media/videos/scene/1080p60/final.mp4   (adicione --format gif para um GIF; -s para um PNG em media/images/scene/final.png)
    
  6. Entrega. Mostre a saída embutida quando sua interface puder exibi-la, ou seja, quando suas instruções disserem que a sintaxe de imagem Markdown incorpora imagens ou vídeo (T3 Code faz isso). Copie o arquivo de saída para o diretório de trabalho da sessão e, em seguida, incorpore-o a partir daí com seu caminho absoluto (![título](/abs/path/out.mp4); isso funciona tanto para MP4 quanto para PNG). O T3 Code renderiza mídia embutida apenas a partir do diretório de trabalho, então uma incorporação apontando para /tmp aparece como um link simples. Em uma interface que mostra apenas texto, como um terminal simples, forneça o caminho absoluto do arquivo de saída. De qualquer forma, forneça também o caminho do arquivo de cena para que o usuário possa ajustá-lo.

    Toda iteração termina com uma entrega. Sempre que você alterar uma cena, seja para o feedback do usuário ou para suas próprias correções, termine a rodada re-renderizando cada vídeo no conjunto na qualidade final, mesmo aqueles que você não tocou, e entregando cada um como no passo 6. Imagens estáticas e quadros de pré-visualização ajudam você a verificar seu trabalho, mas não substituem os vídeos. Dê a cada rodada seus próprios nomes de arquivo (<nome>-v2.mp4, <nome>-v3.mp4), para que mensagens anteriores continuem mostrando as versões que descreveram.

Arquivos de tópico

Cada um contém exemplos testados por renderização, ipsis litteris da documentação v0.22.1, a menos que o arquivo diga o contrário, com um índice no topo.

  • references/basics.md: posicionamento, estilo, agrupamento/organização, .animate, Transform, animações personalizadas.
  • references/text-and-math.md: Text/MarkupText, Tex/MathTex, matemática Typst, coloração de partes de fórmulas, reorganização de equações, listas com marcadores, títulos, blocos de código, chaves, números ao vivo.
  • references/plots-and-axes.md: gráficos Axes, áreas e somas de Riemann, derivadas/secantes, curvas implícitas/paramétricas/polares, eixos logarítmicos, gráficos de linhas de dados, retas e planos numéricos, plano complexo, gráficos de barras.
  • references/diagrams-and-geometry.md: setas, linhas/pontos/formas legendadas, ângulos, ângulos retos, realce (caixa delimitadora, sublinhado, cruz), formas Venn/booleanas, polígonos, contornos tracejados.
  • references/code.md: código com realce de sintaxe: digitando-o, destacando linhas, selecionando um token, transformando uma versão na próxima.
  • references/graphs-tables-matrices.md: Graph/DiGraph nó-link, árvores, camadas de rede neural, importação networkx, alterações de layout, tabelas, matrizes, determinantes, transformações lineares do plano.
  • references/animation-and-motion.md: updaters, ValueTracker, always_redraw, caminhos traçados, variantes de transformação, MoveToTarget/Restore, temporização Succession/LaggedStart, ênfase (Indicate, Circumscribe, Flash), entradas de crescimento/desvanecimento, funções de taxa.
  • references/camera-3d-fields.md: câmera móvel/com zoom, inserção com zoom, controle de câmera ThreeDScene, superfícies e curvas 3D, campos vetoriais e linhas de fluxo.
  • references/complete-scenes.md: duas cenas mais longas mostrando como uma explicação de várias etapas é ritmada.

Consultando a API

O código-fonte instalado, com docstrings completos, está em ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/. Use grep para encontrar a assinatura e as opções de uma classe ou método antes de adivinhar um argumento de palavra-chave.

Pegadinhas

  • Escreva strings LaTeX como strings brutas (r"\frac{a}{b}"). Um erro de LaTeX imprime o log .tex, e a linha ofensiva geralmente está perto do final.
  • xelatex não está instalado, então modelos TexTemplateLibrary que precisam dele (ex.: ctex) falham. Para texto CJK use Text/MarkupText, que renderizam através do Pango com fontes do sistema (fc-list as mostra).
  • Typst / MathTypst são uma alternativa mais rápida a Tex / MathTex e não precisam de LaTeX.
  • Carregue ícones com icon(), que recoloriza ícones Tabler: seus arquivos desenham em currentColor, que um SVGMobject simples lê como preto.
  • Ícones Fluent desenhados em preto (fluent/black-flag, fluent/black-cat) desaparecem no fundo preto; escolha outro ícone ou coloque-o sobre uma forma clara.
  • Ícones de linha Tabler perdem pontos desenhados como linhas de comprimento zero, como as luzes em tabler/outline/server.

Habilidades Relacionadas