Communitygithub.com

manim

Générez des animations explicatives et des diagrammes fixes avec Manim Community. À utiliser lorsqu'un visuel explique mieux qu'un texte (maths, équations, tracés de fonctions, géométrie, graphes/réseaux, tableaux, matrices, 3D, champs vectoriels), ou quand l'utilisateur demande une animation, un diagramme ou une scène Manim.

Qu'est-ce que manim ?

Ce skill permet de créer des animations et diagrammes explicatifs via Manim Community v0.22.1, installé avec les extensions `typst`, TeX Live, `dvisvgm` et Chatterbox Turbo pour la narration vocale. Il prend en charge les images PNG fixes (diagrammes, tracés, tableaux) et les vidéos MP4/GIF (animations pas à pas, transformations). Les scènes utilisent exclusivement l'API ManimCE ; les scripts pour `manimgl` (3Blue1Brown) ne fonctionnent pas. Le skill intègre une bibliothèque d'icônes (Tabler et Fluent), un système de vérification du temps de lecture pour le texte, une narration vocale synchronisée, et une carte de crédit finale indiquant le modèle d'IA générateur. Il propose des exemples testés dans des fichiers thématiques (maths, textes, graphes, etc.) et impose un style dynamique et épuré, avec des règles strictes contre les diagrammes statiques ou trop techniques. Le processus en six étapes guide de l'idée à la livraison : choix du format, recherche d'exemples, écriture de la scène, rendu de brouillon, rendu final, et présentation du résultat dans l'interface utilisateur.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

titre

Documentation

Que fait manim ?

Installé ici : Manim Community v0.22.1 (manim dans le PATH, installé via uv tool avec l'extension typst), ainsi que TeX Live et dvisvgm pour Tex/MathTex, et Chatterbox Turbo pour la narration (installation CPU dans son propre venv sous ~/.local/opt/chatterbox, piloté par narration.py). Les fichiers de scènes s'exécutent sur le propre Python de l'outil, qui inclut numpy, scipy et networkx ; les autres imports échouent. Utilisez uniquement l'API ManimCE. manimgl de 3Blue1Brown est une bibliothèque différente, donc le code qui lui est destiné ne fonctionnera pas ici.

Style

Manim est un outil pour présenter des informations de manière dynamique et intéressante. Si ce que vous avez créé aurait tout aussi bien pu être un organigramme, un tableur, un graphe en points ou un diaporama, vous n'utilisez pas correctement manim. Le beau est plus engageant et plus mémorisable. Évitez le jargon technique, gardez votre présentation accessible. Choisissez un ensemble de motifs et tenez-vous-y – un concept doit avoir une représentation visuelle cohérente. Racontez une histoire, commencez in medias res. Introduisez les idées et les problèmes à partir des premiers principes.

Étapes

  1. Choisissez le format de sortie. Utilisez un PNG fixe pour une image statique (diagramme légendé, tracé, tableau ou formule). Utilisez un MP4 pour montrer un changement ou une séquence (dérivation pas à pas, point en mouvement, transformation). Utilisez un GIF uniquement lorsque le support de destination ne peut pas lire de vidéo.

  2. Trouvez les exemples les plus proches. Ouvrez le ou les fichiers thématiques ci-dessous, parcourez l'index en haut et lisez les 1 à 3 exemples les plus proches de ce dont vous avez besoin. Construisez votre scène en les adaptant : leur utilisation de l'API est connue pour fonctionner sur cette version.

  3. Écrivez la scène dans /tmp/manim/<slug>/scene.py sauf si l'utilisateur a spécifié un emplacement. Commencez par from manim import * et définissez une sous-classe de Scene ( MovingCameraScene / ThreeDScene / ZoomedScene lorsque les exemples en utilisent une).

    Chaque image représentant une chose (un nuage, un serveur, un cadenas, un drapeau, une personne, un document) est une icône de la bibliothèque de ce skill, utilisée telle quelle : copiez icons.py à côté de la scène, trouvez un identifiant avec grep -iw <mot> assets/index.tsv dans le répertoire de ce skill (essayez un synonyme si un mot ne trouve rien), et chargez-la avec icon(id, color=..., height=...). tabler/outline/* et tabler/filled/* sont des icônes linéaires et pleines monochromes (Tabler Icons) dessinées dans la color ; fluent/* sont des emoji en couleur (Fluent Emoji, style Flat) qui conservent leurs propres couleurs. Dessinez vous-même uniquement la structure du diagramme avec les formes de Manim : boîtes, flèches, lignes, axes, tracés et étiquettes. Donnez à chaque concept une icône et réutilisez-la, comme l'un des motifs.

    Un MP4 ou un GIF qui montre du texte doit donner aux spectateurs du temps de lecture, et un vérificateur l'impose. Copiez reading_time.py à côté de la scène, importez-le avec from reading_time import ReadingTime, et placez le mixin avant la classe de base de la scène : class NomDeLaScène(ReadingTime, Scene). Appelez self.wait_to_read() avant chaque play qui cache, remplace ou atténue du texte. Il attend que chaque texte visible soit resté à l'écran pendant 1 s plus le nombre de mots à 150 mots/min, tous les textes révélés par un seul play étant lus ensemble. Montrez les nouveaux mots en tant que nouveaux mobjects (FadeIn, ReplacementTransform) plutôt qu'avec become(), afin que leur temps de lecture reparte de zéro. L'animation peut continuer pendant l'attente : placez self.wait_to_read() après une animation qui se joue pendant que le texte est affiché.

    Un MP4 qui explique avec des légendes est également narré : une voix le lit. Copiez narration.py à côté de la scène et placez-le avant ReadingTime : class NomDeLaScène(Narration, ReadingTime, Scene). self.speak(texte) attend que la ligne précédente se termine, puis commence la suivante, et les animations qui suivent se jouent pendant qu'elle est prononcée. Placez-le juste avant le play qui montre la légende qu'il lit. La légende affiche la ligne parlée mot pour mot, et chaque ligne parlée en a une : écrivez chaque ligne une fois et passez cette même chaîne à speak et au Text de la légende. Lorsque la voix a besoin d'une réécriture que l'écran n'affiche pas ("vingt" pour "20"), placez-la dans le dictionnaire pronounce de la scène, qui modifie uniquement ce qui est prononcé. Dans une scène narrée, la voix définit l'attente au lieu du nombre de mots : le texte qui apparaît pendant qu'une ligne est prononcée doit rester jusqu'à ce que le narrateur ait fini plus une pause de 0,5 s, et self.wait_to_read() attend exactement cette durée avant le changement suivant (le texte affiché en silence conserve la règle du nombre de mots). La voix est un clone neuronal d'un narrateur masculin calme (Chatterbox Turbo), réglé pour parcourir des diagrammes techniques. Chaque nouvelle ligne prend environ 1 à 3 fois sa longueur parlée à synthétiser (y compris les brouillons d'images fixes) et est mise en cache dans media/voice, donc les rendus ultérieurs ne vocalisent que les lignes modifiées. Écrivez chaque ligne pour être entendue, pas lue. Les acronymes comme API, TLS et HTTP se lisent bien tels quels, et narration.py épelle déjà les unités après les nombres (200 ms), les versions pointées (2.4.1) et k8s. Dites les autres chaînes machine comme le ferait un narrateur, toujours via pronounce : "dix-sept onze", pas "2026.11.1711". Décrivez les chemins et noms de branches plutôt que de les lire textuellement ("une branche de correction automatique de patchs"), et corrigez tout mot que la voix prononce mal via le dictionnaire pronounce de la scène ({"edgeworker": "edge worker"}).

    Chaque MP4 ou GIF se termine par une carte de crédit indiquant le modèle qui l'a créé. Copiez produced_by.py à côté de la scène, placez le mixin en premier : class NomDeLaScène(ProducedBy, Narration, ReadingTime, Scene) (ou class NomDeLaScène(ProducedBy, Scene) pour une scène sans texte), et définissez produced_by avec le nom de votre propre modèle tel que donné par votre prompt système (produced_by = "Claude Opus 5.5"). Si vos instructions ne donnent pas le nom de votre modèle, demandez à l'utilisateur. Une fois la scène, sa narration et sa vérification du temps de lecture terminées, le mixin fond la scène et maintient la carte pendant les 0,5 dernières secondes. Les rendus statiques l'omettent.

  4. Brouillon et inspection. Effectuez un rendu basse qualité d'une image fixe et lisez le PNG :

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

    Pour une animation, vérifiez aussi les moments clés : -s -n 0,K s'arrête après l'animation K (à partir de 0 ; chaque self.play et chaque self.wait compte pour un) et enregistre cette image. L'image fait environ 14,2 × 8 unités, centrée sur l'origine. Corrigez et refaites le rendu jusqu'à ce que chaque image vérifiée montre tous les éléments dans le cadre, sans étiquettes qui se chevauchent, et un texte lisible.

    Une scène qui retire le texte trop tôt échoue avec une ReadingTimeError, qui liste chaque texte, son apparition et sa durée d'affichage par rapport à la durée requise. Ajoutez self.wait_to_read() avant chaque changement listé. Pour inspecter les images du brouillon avant que la synchronisation ne soit corrigée, préfixez la commande par MANIM_READING_TIME=warn. Le rendu final s'effectue sans cela et doit réussir.

  5. Rendu final. Utilisez -qm (720p30). Les scènes 3D sont lentes sur le rendu Cairo, donc faites-en un brouillon en -ql.

    manim render -qh --media_dir media -o final scene.py NomDeLaScène
    # -> media/videos/scene/1080p60/final.mp4   (ajoutez --format gif pour un GIF ; -s pour un PNG dans media/images/scene/final.png)
    
  6. Livraison. Affichez la sortie en ligne lorsque votre interface peut l'afficher, c'est-à-dire lorsque vos instructions disent que la syntaxe Markdown d'image incorpore des images ou des vidéos (comme le fait T3 Code). Copiez le fichier de sortie dans le répertoire de travail de la session, puis intégrez-le à partir de là avec son chemin absolu (![titre](/chemin/abs/sortie.mp4) ; cela fonctionne à la fois pour MP4 et PNG). T3 Code rend les médias en ligne uniquement depuis le répertoire de travail, donc une intégration pointant vers /tmp apparaît comme un lien simple. Dans une interface qui n'affiche que du texte, comme un terminal simple, donnez plutôt le chemin absolu du fichier de sortie. Dans les deux cas, donnez aussi le chemin du fichier de scène pour que l'utilisateur puisse le modifier.

    Chaque itération se termine par une livraison. Chaque fois que vous modifiez une scène, que ce soit suite aux retours de l'utilisateur ou pour vos propres corrections, terminez le tour en refaisant le rendu de chaque vidéo de l'ensemble en qualité finale (même celles que vous n'avez pas touchées), et livrez chacune d'elles comme à l'étape 6. Les images fixes et les captures d'écran vous aident à vérifier votre travail, mais ne remplacent pas les vidéos. Donnez à chaque tour ses propres noms de fichiers (<nom>-v2.mp4, <nom>-v3.mp4), afin que les messages précédents continuent d'afficher les versions qu'ils décrivaient.

Fichiers thématiques

Chacun contient des exemples testés par rendu, textuellement issus de la documentation v0.22.1 sauf mention contraire, avec un index en haut.

  • references/basics.md : positionnement, style, regroupement/disposition, .animate, Transform, animations personnalisées.
  • references/text-and-math.md : Text/MarkupText, Tex/MathTex, mathématiques Typst, coloration de parties de formules, réarrangement d'équations, listes à puces, titres, blocs de code, accolades, nombres en direct.
  • references/plots-and-axes.md : tracés Axes, aires et sommes de Riemann, dérivées/sécantes, courbes implicites/paramétriques/polaires, axes logarithmiques, graphiques linéaires de données, droites et plans numériques, plan complexe, diagrammes à barres.
  • references/diagrams-and-geometry.md : flèches, droites/points/formes étiquetées, angles, angles droits, mise en évidence (boîte englobante, soulignement, croix), formes Venn/algèbre de Boole, polygones, contours en pointillés.
  • references/code.md : code avec coloration syntaxique : saisie au clavier, mise en évidence de lignes, extraction d'un jeton, transformation d'une version en la suivante.
  • references/graphs-tables-matrices.md : Graph/DiGraph nœuds-liens, arbres, couches de réseaux de neurones, import networkx, changements de disposition, tableaux, matrices, déterminants, transformations linéaires du plan.
  • references/animation-and-motion.md : updaters, ValueTracker, always_redraw, chemins tracés, variantes de transformation, MoveToTarget/Restore, synchronisation Succession/LaggedStart, accentuation (Indicate, Circumscribe, Flash), entrées par croissance/fondu, fonctions de taux.
  • references/camera-3d-fields.md : caméra mobile/zoom, incrustation zoomée, contrôle de caméra ThreeDScene, surfaces et courbes 3D, champs vectoriels et lignes de courant.
  • references/complete-scenes.md : deux scènes plus longues montrant comment rythmer une explication en plusieurs étapes.

Consultation de l'API

La source installée, avec les docstrings complètes, se trouve dans ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/. Utilisez grep pour trouver la signature et les options d'une classe ou d'une méthode avant de deviner un argument nommé.

Pièges

  • Écrivez les chaînes LaTeX comme des chaînes brutes (r"\frac{a}{b}"). Une erreur LaTeX imprime le journal .tex, et la ligne problématique se trouve généralement vers la fin.
  • xelatex n'est pas installé, donc les modèles TexTemplateLibrary qui en ont besoin (par ex. ctex) échouent. Pour le texte CJK, utilisez Text/MarkupText, qui s'affichent via Pango avec les polices système (fc-list les affiche).
  • Typst / MathTypst sont une alternative plus rapide à Tex / MathTex et ne nécessitent pas LaTeX.
  • Chargez les icônes avec icon(), qui recolore les icônes Tabler : leurs fichiers sont dessinés avec currentColor, qu'un simple SVGMobject lit comme noir.
  • Les icônes Fluent dessinées en noir (fluent/black-flag, fluent/black-cat) disparaissent sur fond noir ; choisissez une autre icône ou placez-la sur une forme claire.
  • Les icônes linéaires Tabler perdent les points dessinés comme des lignes de longueur nulle, par exemple les lumières sur tabler/outline/server.

Skills associés