Communitygithub.com

MoreiraTv/vibe-video

Produktionspipeline für mathematische und technische Animationen mit Manim Community Edition. Erstellt Erklärvideos im Stil von 3Blue1Brown, Algorithmusvisualisierungen, Gleichungsableitungen, Architekturdiagramme und Daten-Geschichten.

Was ist vibe-video?

Diese AI-Agent-Fähigkeit (Skill) verwandelt Benutzereingaben in kinematografische Erklärvideos, die von einem Manim Community Edition-basierten Produktionssystem gerendert werden. Sie unterstützt mehrere Modi – Konzepterklärer, Gleichungsableitung, Algorithmusvisualisierung, Daten-Geschichte, Architekturdiagramm, Paper-Erklärer und 3D-Visualisierung – und stellt sicher, dass die Ausgabe pädagogisch fundiert und visuell kohärent ist. Die Pipeline umfasst Planung, Codierung, Rendering, Zusammenschnitt und optionale Audiospur, wobei alle Szenen in einem einzigen Python-Skript definiert sind. Plattformen: Claude Code, Cursor, Codex, die Manim CE v0.20+, LaTeX, ffmpeg und optional TTS-Engines (ElevenLabs, Qwen3-TTS) erfordern. Der Skill setzt strenge ästhetische Standards durch, darunter Ebenen-Transparenz, konsistente Typografie (Monospace-Schriftarten), animierte Tempi und eine kreative Abteilung (SCAMPER/Assumptions Reversal) für experimentelle Ergebnisse.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MoreiraTv/vibe-video/tree/HEAD/skills/manim-video

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Manim Video-Produktionspipeline

Kreativstandard

Dies ist Bildungskino. Jeder Frame lehrt. Jede Animation enthüllt Struktur.

Bevor Sie eine einzige Zeile Code schreiben, artikulieren Sie den Erzählbogen. Welches Missverständnis korrigiert dies? Was ist der "Aha-Moment"? Welche visuelle Geschichte führt den Zuschauer von Verwirrung zu Verständnis? Der Prompt des Benutzers ist ein Ausgangspunkt – interpretieren Sie ihn mit pädagogischem Ehrgeiz.

Geometrie vor Algebra. Zeigen Sie zuerst die Form, dann die Gleichung. Das visuelle Gedächtnis kodiert schneller als das symbolische Gedächtnis. Wenn der Zuschauer das geometrische Muster vor der Formel sieht, fühlt sich die Gleichung verdient an.

Exzellenz beim ersten Rendern ist nicht verhandelbar. Die Ausgabe muss visuell klar und ästhetisch kohärent sein, ohne Überarbeitungsrunden. Wenn etwas überladen, schlecht getimt oder wie "KI-generierte Folien" aussieht, ist es falsch.

Schichtung der Deckkraft lenkt die Aufmerksamkeit. Zeigen Sie niemals alles in voller Helligkeit. Primäre Elemente bei 1,0, kontextuelle Elemente bei 0,4, strukturelle Elemente (Achsen, Gitter) bei 0,15. Das Gehirn verarbeitet visuelle Auffälligkeit in Schichten.

Atempause. Jede Animation benötigt ein self.wait() danach. Der Zuschauer braucht Zeit, um das gerade Erschienene zu verarbeiten. Überstürzen Sie nie eine Animation mit der nächsten. Eine 2-Sekunden-Pause nach einer Schlüsselenthüllung ist nie verschwendet.

Kohärente visuelle Sprache. Alle Szenen teilen sich eine Farbpalette, konsistente Schriftgrößen und passende Animationsgeschwindigkeiten. Ein technisch korrektes Video, in dem jede Szene zufällige, unterschiedliche Farben verwendet, ist ein ästhetischer Fehlschlag.

Voraussetzungen

Führen Sie scripts/setup.sh aus, um alle Abhängigkeiten zu überprüfen. Erfordert: Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (texlive-full auf Linux, mactex auf macOS) und ffmpeg. Referenzdokumentation getestet mit Manim CE v0.20.1.

Modi

ModusEingabeAusgabeReferenz
KonzepterklärerThema/KonzeptAnimierte Erklärung mit geometrischer Intuitionreferences/scene-planning.md
GleichungsableitungMathematische AusdrückeSchrittweise animierter Beweisreferences/equations.md
AlgorithmusvisualisierungAlgorithmusbeschreibungSchrittweise Ausführung mit Datenstrukturenreferences/graphs-and-data.md
Daten-GeschichteDaten/MetrikenAnimierte Diagramme, Vergleiche, Zählerreferences/graphs-and-data.md
ArchitekturdiagrammSystembeschreibungKomponenten, die sich mit Verbindungen aufbauenreferences/mobjects.md
Paper-ErklärerForschungspapierWichtige Ergebnisse und Methoden animiertreferences/scene-planning.md
3D-Visualisierung3D-KonzeptRotierende Oberflächen, parametrische Kurven, räumliche Geometriereferences/camera-and-3d.md

Technologie-Stack

Ein einzelnes Python-Skript pro Projekt. Kein Browser, kein Node.js, keine GPU erforderlich.

SchichtWerkzeugZweck
KernManim Community EditionSzenen-Rendering, Animations-Engine
MathematikLaTeX (texlive/MiKTeX)Gleichungs-Rendering über MathTex
Video-E/AffmpegSzenen-Zusammenschnitt, Formatkonvertierung, Audio-Muxing
TTSElevenLabs / Qwen3-TTS (optional)Sprach-Overlay

Pipeline

PLAN --> CODE --> RENDER --> STITCH --> AUDIO (optional) --> REVIEW
  1. PLAN – Schreiben Sie plan.md mit Erzählbogen, Szenenliste, visuellen Elementen, Farbpalette, Sprach-Overlay-Skript
  2. CODE – Schreiben Sie script.py mit einer Klasse pro Szene, jede unabhängig renderbar
  3. RENDER – manim -ql script.py Scene1 Scene2 ... für Entwurf, -qh für Produktion
  4. STITCH – ffmpeg concat der Szenenclips zu final.mp4
  5. AUDIO (optional) – Fügen Sie Sprach-Overlay und/oder Hintergrundmusik über ffmpeg hinzu. Siehe references/rendering.md
  6. REVIEW – Rendern Sie Vorschaubilder, überprüfen Sie gegen den Plan, passen Sie an

Projektstruktur

project-name/
  plan.md                # Erzählbogen, Szenenaufschlüsselung
  script.py              # Alle Szenen in einer Datei
  concat.txt             # ffmpeg-Szenenliste
  final.mp4              # Zusammengeschnittene Ausgabe
  media/                 # Automatisch von Manim generiert
    videos/script/480p15/

Kreative Richtlinien

Farbpaletten

PaletteHintergrundPrimärSekundärAkzentAnwendungsfall
Klassisch 3B1B#1C1C1C#58C4DD (BLAU)#83C167 (GRÜN)#FFFF00 (GELB)Allgemein Mathe/Informatik
Warm akademisch#2D2B55#FF6B6B#FFD93D#6BCB77Zugänglich
Neon Tech#0A0A0A#00F5FF#FF00FF#39FF14Systeme, Architektur
Monochrom#1A1A2E#EAEAEA#888888#FFFFFFMinimalistisch

Animationsgeschwindigkeit

Kontextrun_timeself.wait() danach
Titel/Einführung erscheint1,5s1,0s
Schlüsselgleichung enthüllen2,0s2,0s
Transformieren/Morph1,5s1,5s
Unterstützendes Label0,8s0,5s
FadeOut-Bereinigung0,5s0,3s
"Aha-Moment"-Enthüllung2,5s3,0s

Typografie-Skala

RolleSchriftgrößeVerwendung
Titel48Szenentitel, Eröffnungstext
Überschrift36Abschnittsüberschriften innerhalb einer Szene
Fließtext30Erklärender Text
Label24Anmerkungen, Achsenbeschriftungen
Bildunterschrift20Untertitel, Kleingedrucktes

Schriftarten

Verwenden Sie Monospace-Schriftarten für den gesamten Text. Manims Pango-Renderer erzeugt gebrochenes Kerning mit proportionalen Schriftarten in allen Größen. Siehe references/visual-design.md für vollständige Empfehlungen.

MONO = "Menlo"  # einmal am Anfang der Datei definieren

Text("Fourier Series", font_size=48, font=MONO, weight=BOLD)  # Titel
Text("n=1: sin(x)", font_size=20, font=MONO)                  # Labels
MathTex(r"\nabla L")                                            # Mathematik (verwendet LaTeX)

Mindest-font_size=18 für Lesbarkeit.

Variation pro Szene

Verwenden Sie niemals eine identische Konfiguration für alle Szenen. Für jede Szene:

  • Andere dominante Farbe aus der Palette
  • Anderes Layout – zentrieren Sie nicht immer alles
  • Anderer Animationseintritt – variieren Sie zwischen Write, FadeIn, GrowFromCenter, Create
  • Anderes visuelles Gewicht – einige Szenen dicht, andere spärlich

Workflow

Schritt 1: Plan (plan.md)

Schreiben Sie vor jedem Code plan.md. Siehe references/scene-planning.md für die umfassende Vorlage.

Schritt 2: Code (script.py)

Eine Klasse pro Szene. Jede Szene ist unabhängig renderbar.

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Scene1_Introduction(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("Warum funktioniert das?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Warum funktioniert das?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

Wichtige Muster:

  • Untertitel bei jeder Animation: self.add_subcaption("text", duration=N) oder subcaption="text" bei self.play()
  • Geteilte Farbkonstanten am Dateianfang für szenenübergreifende Konsistenz
  • self.camera.background_color wird in jeder Szene gesetzt
  • Saubere Ausgänge – FadeOut aller Mobjekte am Szenenende: self.play(FadeOut(Group(*self.mobjects)))

Schritt 3: Rendern

manim -ql script.py Scene1_Introduction Scene2_CoreConcept  # Entwurf
manim -qh script.py Scene1_Introduction Scene2_CoreConcept  # Produktion

Schritt 4: Zusammenschnitt

cat > concat.txt << 'EOF'
datei 'media/videos/script/480p15/Scene1_Introduction.mp4'
datei 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

Schritt 5: Überprüfung

manim -ql --format=png -s script.py Scene2_CoreConcept  # Vorschaubild

Kritische Implementierungshinweise

Raw Strings für LaTeX

# FALSCH: MathTex("\frac{1}{2}")
# RICHTIG:
MathTex(r"\frac{1}{2}")

buff >= 0,5 für Randtext

label.to_edge(DOWN, buff=0.5)  # niemals < 0,5

FadeOut vor dem Ersetzen von Text

self.play(ReplacementTransform(note1, note2))  # nicht Write(note2) darüberlegen

Niemals Nicht-Hinzugefügte Mobjekte animieren

self.play(Create(circle))  # muss zuerst hinzugefügt werden
self.play(circle.animate.set_color(RED))  # dann animieren

Leistungsziele

QualitätAuflösungFPSGeschwindigkeit
-ql (Entwurf)854x480155-15s/Szene
-qm (mittel)1280x7203015-60s/Szene
-qh (Produktion)1920x10806030-120s/Szene

Immer bei -ql iterieren. Nur -qh für die endgültige Ausgabe rendern.

Referenzen

DateiInhalt
references/animations.mdKernanimationen, Geschwindigkeitsfunktionen, Komposition, .animate-Syntax, Timing-Muster
references/mobjects.mdText, Formen, VGroup/Group, Positionierung, Styling, benutzerdefinierte Mobjekte
references/visual-design.md12 Designprinzipien, Deckkraft-Schichtung, Layout-Vorlagen, Farbpaletten
references/equations.mdLaTeX in Manim, TransformMatchingTex, Ableitungsmuster
references/graphs-and-data.mdAchsen, Plotten, BarChart, animierte Daten, Algorithmusvisualisierung
references/camera-and-3d.mdMovingCameraScene, ThreeDScene, 3D-Oberflächen, Kamerasteuerung
references/scene-planning.mdErzählbögen, Layout-Vorlagen, Szenenübergänge, Planungsvorlage
references/rendering.mdCLI-Referenz, Qualitätsvoreinstellungen, ffmpeg, Sprach-Overlay-Workflow, GIF-Export
references/troubleshooting.mdLaTeX-Fehler, Animationsfehler, häufige Fehler, Debugging
references/animation-design-thinking.mdWann animieren vs. statisch anzeigen, Zerlegung, Tempo, Synchronisation der Erzählung
references/updaters-and-trackers.mdValueTracker, add_updater, always_redraw, zeitbasierte Updater, Muster
references/paper-explainer.mdForschungspapiere in Animationen verwandeln – Workflow, Vorlagen, Domänenmuster
references/decorations.mdSurroundingRectangle, Brace, Pfeile, DashedLine, Angle, Lebenszyklus von Annotationen
references/production-quality.mdChecklisten vor dem Code, vor dem Rendern, nach dem Rendern, räumliches Layout, Farbe, Tempo

Kreative Abweichung (nur verwenden, wenn der Benutzer experimentelle/kreative/einzigartige Ausgabe wünscht)

Wenn der Benutzer nach kreativen, experimentellen oder unkonventionellen Erklärungsansätzen fragt, wählen Sie eine Strategie aus und denken Sie diese VOR dem Entwurf der Animation durch.

  • SCAMPER – wenn der Benutzer eine neue Perspektive auf eine Standarderklärung wünscht
  • Annahme-Umkehrung – wenn der Benutzer hinterfragen möchte, wie etwas normalerweise gelehrt wird

SCAMPER-Transformation

Nehmen Sie eine Standard-Mathematik-/Technik-Visualisierung und transformieren Sie sie:

  • Substitute (Ersetzen): Ersetzen Sie die Standard-Visualisierungsmetapher (Zahlenstrahl → verschlungener Pfad, Matrix → Stadtgitter)
  • Combine (Kombinieren): Verschmelzen Sie zwei Erklärungsansätze (algebraisch + geometrisch gleichzeitig)
  • Reverse (Umkehren): Leiten Sie rückwärts ab – beginnen Sie mit dem Ergebnis und dekonstruieren Sie zu Axiomen
  • Modify (Modifizieren): Übertreiben Sie einen Parameter, um zu zeigen, warum er wichtig ist (10-fache Lernrate, 1000-fache Stichprobengröße)
  • Eliminate (Entfernen): Entfernen Sie die gesamte Notation – erklären Sie rein durch Animation und räumliche Beziehungen

Annahme-Umkehrung

  1. Listen Sie auf, was "Standard" an der Visualisierung dieses Themas ist (links-nach-rechts, 2D, diskrete Schritte, formale Notation)
  2. Wählen Sie die grundlegendste Annahme aus
  3. Kehren Sie sie um (rechts-nach-links-Ableitung, 3D-Einbettung eines 2D-Konzepts, kontinuierliches Morphen statt Schritte, Null Notation)
  4. Erkunden Sie, was die Umkehrung enthüllt, was der Standardansatz verbirgt

Verwandte Skills