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
-
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.
-
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.
-
Escreva a cena em
/tmp/manim/<slug>/scene.py, a menos que o usuário tenha nomeado um local. Comece comfrom manim import *e defina uma subclasse deScene(MovingCameraScene/ThreeDScene/ZoomedScenequando 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.tsvno diretório desta skill (tente um sinônimo quando uma palavra não encontrar nada), e carregue-o comicon(id, color=..., height=...).tabler/outline/*etabler/filled/*são ícones de linha e sólidos monocromáticos (Tabler Icons) desenhados emcolor;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 ReadingTimee coloque o mixin antes da classe base da cena:class SceneName(ReadingTime, Scene). Chameself.wait_to_read()antes de cadaplayque 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 umplaylido em conjunto. Mostre novas palavras como um novo mobject (FadeIn,ReplacementTransform) em vez de usarbecome(), para que seu tempo comece do zero. A animação pode continuar durante a espera: coloqueself.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 doplayque 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 paraspeake para oTextda legenda. Quando a voz precisar de uma reescrita que a tela não mostra ("vinte" para "20"), coloque-a no dicionáriopronounceda 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, eself.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 emmedia/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, enarration.pyjá soletra unidades após números (200 ms), versões pontuadas (2.4.1) ek8s. Diga outras strings de máquina como um narrador diria, novamente através depronounce: "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áriopronounceda 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)(ouclass SceneName(ProducedBy, Scene)para uma cena sem texto), e definaproduced_bycom 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. -
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.pngPara uma animação, verifique também os momentos-chave:
-s -n 0,Kpara após a animação K (base 0; cadaself.playe cadaself.waitconta 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. Adicioneself.wait_to_read()antes de cada mudança listada. Para visualizar quadros de rascunho antes que o tempo seja corrigido, prefixe o comando comMANIM_READING_TIME=warn. A renderização final é executada sem ele e deve passar. -
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) -
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 (
; 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/tmpaparece 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/DiGraphnó-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çãoSuccession/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. xelatexnão está instalado, então modelosTexTemplateLibraryque precisam dele (ex.:ctex) falham. Para texto CJK useText/MarkupText, que renderizam através do Pango com fontes do sistema (fc-listas mostra).Typst/MathTypstsão uma alternativa mais rápida aTex/MathTexe não precisam de LaTeX.- Carregue ícones com
icon(), que recoloriza ícones Tabler: seus arquivos desenham emcurrentColor, que umSVGMobjectsimples 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.