¿Qué hace manim?
Instalado aquí: Manim Community v0.22.1 (manim en PATH, instalado como uv tool con el extra typst), además de TeX Live y dvisvgm para Tex/MathTex, y Chatterbox Turbo para narración (instalación para CPU en su propio entorno virtual en ~/.local/opt/chatterbox, manejado por narration.py). Los archivos de escena se ejecutan con el Python propio de la herramienta, que incluye numpy, scipy y networkx; otras importaciones fallan. Usa únicamente la API de ManimCE. manimgl de 3Blue1Brown es una biblioteca diferente, por lo que el código escrito para ella no funcionará aquí.
Estilo
Manim es una herramienta para presentar información de forma dinámica e interesante. Si lo que has creado podría haberse hecho igual de fácil como un diagrama de flujo, una hoja de cálculo, un gráfico de puntos o una presentación de diapositivas, no estás usando manim correctamente. Lo bello es más atractivo y más memorable. Evita la jerga técnica y mantén tu presentación accesible. Elige un conjunto de motivos y mantenlos fieles: un concepto debe tener una representación visual coherente. Cuenta una historia, comienza in medias res. Introduce las ideas y los problemas desde los primeros principios.
Pasos
-
Elige el formato de salida. Usa un PNG estático para una imagen fija (un diagrama etiquetado, gráfico, tabla o fórmula). Usa un MP4 cuando el punto sea el cambio o la secuencia (una derivación paso a paso, un punto en movimiento, una transformación). Usa GIF solo cuando el lugar donde irá no pueda reproducir video.
-
Encuentra los ejemplos más cercanos. Abre los archivos de tema a continuación, revisa el índice al principio y lee los 1–3 ejemplos más cercanos a lo que necesitas. Construye tu escena adaptándolos: su uso de la API está probado en esta versión.
-
Escribe la escena en
/tmp/manim/<slug>/scene.pya menos que el usuario haya especificado una ubicación. Comienza confrom manim import *y define una subclase deScene(MovingCameraScene/ThreeDScene/ZoomedScenecuando los ejemplos lo usen).Cada imagen de una cosa (una nube, un servidor, un candado, una bandera, una persona, un documento) es un icono de la biblioteca de esta habilidad, usado tal cual: copia icons.py junto a la escena, encuentra un id con
grep -iw <palabra> assets/index.tsven el directorio de esta habilidad (prueba un sinónimo si una palabra no encuentra nada), y cárgalo conicon(id, color=..., height=...).tabler/outline/*ytabler/filled/*son iconos de un solo color (Tabler Icons) dibujados encolor;fluent/*son emojis a todo color (Fluent Emoji, estilo plano) que mantienen sus propios colores. Dibuja solo la estructura del diagrama tú mismo, con las formas de Manim: cajas, flechas, líneas, ejes, gráficos y etiquetas. Dale a cada concepto un icono y reutilízalo, como uno de los motivos.Un MP4 o GIF que muestre texto debe dar a los espectadores tiempo de lectura, y un verificador lo exige. Copia reading_time.py junto a la escena, impórtalo con
from reading_time import ReadingTime, y pon el mixin antes de la clase base de la escena:class SceneName(ReadingTime, Scene). Llama aself.wait_to_read()antes de cadaplayque oculte, reemplace o atenúe texto. Espera hasta que cada texto visible haya estado en pantalla durante 1 s más sus palabras a 150 ppm, con todo el texto revelado por unplayleído en conjunto. Muestra las palabras nuevas como un nuevo mobject (FadeIn,ReplacementTransform) en lugar de conbecome(), para que su tiempo comience de nuevo. El movimiento puede continuar durante la espera: ponself.wait_to_read()después de una animación que se reproduzca mientras el texto está visible.Un MP4 que explique con subtítulos también está narrado: una voz lo lee en voz alta. Copia narration.py junto a la escena y ponlo antes de
ReadingTime:class SceneName(Narration, ReadingTime, Scene).self.speak(texto)espera a que termine la línea anterior, luego comienza la siguiente, y las animaciones que siguen se reproducen mientras se habla. Ponlo justo antes delplayque muestra el subtítulo que lee. El subtítulo muestra la línea hablada palabra por palabra, y cada línea hablada tiene uno: escribe cada línea una vez y pasa esa misma cadena aspeaky alTextdel subtítulo. Cuando la voz necesite una reescritura que la pantalla no muestra ("veinte" para "20"), ponlo en el diccionariopronouncede la escena, que cambia solo lo que se vocaliza. En una escena narrada, la voz establece la espera en lugar del recuento de palabras: el texto que aparece mientras se habla una línea debe permanecer hasta que el narrador termine más una pausa de 0.5 s, yself.wait_to_read()espera exactamente ese tiempo antes del siguiente cambio (el texto mostrado durante el silencio mantiene la regla del recuento de palabras). La voz es un clon neuronal de un narrador masculino calmado (Chatterbox Turbo), ajustado para recorrer diagramas técnicos. Cada nueva línea toma aproximadamente de 1 a 3 veces su duración hablada para sintetizar, incluidos los fotogramas de borrador, y se almacena en caché enmedia/voice, por lo que los renderizados posteriores solo vocalizan las líneas que cambiaste. Escribe cada línea para ser escuchada, no leída. Acrónimos como API, TLS y HTTP se leen bien como están escritos, ynarration.pyya deletrea las unidades después de números (200 ms), versiones con puntos (2.4.1) yk8s. Di otras cadenas de máquina como lo haría un narrador, nuevamente a través depronounce: "diecisiete once", no "2026.11.1711". Describe rutas y nombres de ramas en lugar de leerlos en voz alta ("una rama de parches automáticos"), y corrige cualquier palabra que la voz pronuncie mal mediante el diccionariopronouncede la escena ({"edgeworker": "trabajador de borde"}).Cada MP4 o GIF termina en una tarjeta de crédito que nombra el modelo que lo creó. Copia produced_by.py junto a la escena, pon el mixin primero de todos:
class SceneName(ProducedBy, Narration, ReadingTime, Scene)(oclass SceneName(ProducedBy, Scene)para una escena sin texto), y estableceproduced_bycon el nombre de tu propio modelo tal como lo da tu prompt del sistema (produced_by = "Claude Opus 5.5"). Si tus instrucciones no nombran tu modelo, pregúntale al usuario. Una vez que la escena, su narración y su verificación de tiempo de lectura hayan terminado, el mixin desvanece la escena y mantiene la tarjeta durante los últimos 0.5 s. Los renderizados estáticos lo omiten. -
Boceto y revisión. Renderiza un borrador de baja calidad y lee el PNG:
cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py SceneName # -> media/images/scene/draft.pngPara una animación, también verifica los momentos clave:
-s -n 0,Kse detiene después de la animación K (basado en 0; cadaself.playy cadaself.waitcuenta como uno) y guarda ese fotograma. El fotograma mide aproximadamente 14.2 × 8 unidades, centrado en el origen. Corrige y vuelve a renderizar hasta que cada fotograma que verificaste muestre todos los elementos dentro del marco, sin etiquetas superpuestas y texto legible.Una escena que quita el texto demasiado pronto falla con
ReadingTimeError, que enumera cada texto, cuándo apareció, cuánto tiempo se mostró frente al tiempo necesario. Agregaself.wait_to_read()antes de cada cambio enumerado. Para ver los fotogramas del borrador antes de que se corrija el tiempo, antepone el comando conMANIM_READING_TIME=warn. El renderizado final se ejecuta sin esto y debe pasar. -
Renderizado final. Usa
-qm(720p30). Las escenas 3D son lentas en el renderizador Cairo, así que haz el borrador con-ql.manim render -qh --media_dir media -o final scene.py SceneName # -> media/videos/scene/1080p60/final.mp4 (agrega --format gif para un GIF; -s para un PNG en media/images/scene/final.png) -
Entrega. Muestra la salida en línea cuando tu interfaz pueda mostrarla, es decir, cuando tus instrucciones digan que la sintaxis de imagen Markdown incrusta imágenes o video (lo hace T3 Code). Copia el archivo de salida al directorio de trabajo de la sesión, luego incrústalo desde allí con su ruta absoluta (
; esto funciona tanto para MP4 como para PNG). T3 Code renderiza medios en línea solo desde el directorio de trabajo, por lo que una incrustación que apunte a/tmpse muestra como un enlace simple. En una interfaz que solo muestra texto, como una terminal simple, proporciona la ruta absoluta del archivo de salida. En cualquier caso, también proporciona la ruta del archivo de la escena para que el usuario pueda modificarla.Cada iteración termina en una entrega. Cada vez que cambies una escena, ya sea por los comentarios del usuario o por tus propias correcciones, finaliza el turno volviendo a renderizar cada video del conjunto en calidad final, incluso aquellos que no tocaste, y entregando cada uno como en el paso 6. Las imágenes fijas y las capturas de fotogramas te ayudan a verificar tu trabajo, pero no reemplazan los videos. Dale a cada ronda sus propios nombres de archivo (
<nombre>-v2.mp4,<nombre>-v3.mp4), para que los mensajes anteriores sigan mostrando las versiones que describieron.
Archivos de tema
Cada uno contiene ejemplos probados con renderizado, textualmente de la documentación v0.22.1 a menos que el archivo indique lo contrario, con un índice al principio.
- references/basics.md: posicionamiento, estilo, agrupación/organización,
.animate,Transform, animaciones personalizadas. - references/text-and-math.md:
Text/MarkupText,Tex/MathTex, matemáticas con Typst, colorear partes de fórmulas, reorganización de ecuaciones, listas con viñetas, títulos, bloques de código, llaves, números en vivo. - references/plots-and-axes.md: gráficos
Axes, áreas y sumas de Riemann, derivadas/secantes, curvas implícitas/paramétricas/polares, ejes logarítmicos, gráficos de líneas de datos, rectas numéricas y planos, plano complejo, gráficos de barras. - references/diagrams-and-geometry.md: flechas, líneas/puntos/formas etiquetados, ángulos, ángulos rectos, resaltado (cuadro alrededor, subrayado, cruz), formas de Venn/booleanas, polígonos, contornos discontinuos.
- references/code.md: código con resaltado de sintaxis: escribirlo, resaltar líneas, seleccionar un token, transformar una versión en la siguiente.
- references/graphs-tables-matrices.md:
Graph/DiGraphde nodos y enlaces, árboles, capas de redes neuronales, importación de networkx, cambios de diseño, tablas, matrices, determinantes, transformaciones lineales del plano. - references/animation-and-motion.md: actualizadores,
ValueTracker,always_redraw, rutas trazadas, variantes de transformación,MoveToTarget/Restore, temporizaciónSuccession/LaggedStart, énfasis (Indicate,Circumscribe,Flash), entradas de crecimiento/desvanecimiento, funciones de ritmo. - references/camera-3d-fields.md: cámara móvil/zoom, recuadro con zoom, control de cámara
ThreeDScene, superficies y curvas 3D, campos vectoriales y líneas de flujo. - references/complete-scenes.md: dos escenas más largas que muestran cómo se ritma una explicación de varios pasos.
Consulta de la API
El código fuente instalado, con cadenas de documentación completas, está en ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/. Búscalo para obtener la firma y las opciones de una clase o método antes de adivinar un argumento de palabra clave.
Advertencias
- Escribe las cadenas LaTeX como cadenas sin procesar (
r"\frac{a}{b}"). Un error de LaTeX imprime el registro.tex, y la línea problemática suele estar cerca del final. xelatexno está instalado, por lo que las plantillas deTexTemplateLibraryque lo necesitan (por ejemplo,ctex) fallan. Para texto CJK usaText/MarkupText, que se renderizan a través de Pango con las fuentes del sistema (fc-listlas muestra).Typst/MathTypstson una alternativa más rápida aTex/MathTexy no necesitan LaTeX.- Carga los iconos con
icon(), que recolorea los iconos de Tabler: sus archivos dibujan encurrentColor, que unSVGMobjectsimple lee como negro. - Los iconos Fluent dibujados en negro (
fluent/black-flag,fluent/black-cat) desaparecen sobre el fondo negro; elige otro icono, o colócalo sobre una forma clara. - Los iconos de línea de Tabler pierden los puntos dibujados como líneas de longitud cero, como las luces en
tabler/outline/server.