Communitygithub.com

manim

Manim 커뮤니티 에디션으로 설명 애니메이션과 정적 다이어그램을 렌더링합니다. 수학, 방정식, 함수 그래프, 기하학, 그래프/네트워크, 표, 행렬, 3D, 벡터장 등 텍스트보다 시각 자료가 더 잘 설명할 수 있는 경우나 사용자가 애니메이션, 다이어그램 또는 Manim 씬을 요청할 때 사용합니다.

manim란 무엇인가요?

이 스킬은 Manim Community v0.22.1을 활용하여 수학, 과학, 엔지니어링 개념을 위한 고품질 설명 애니메이션과 정적 다이어그램을 생성합니다. TeX Live, dvisvgm, Chatterbox Turbo 음성 합성 등이 사전 설치되어 있으며, numpy, scipy, networkx를 Python 환경에서 사용할 수 있습니다. 3Blue1Brown의 manimgl과는 별개이므로 해당 라이브러리용 코드는 호환되지 않습니다. 이 스킬은 아이콘 라이브러리(Tabler 아이콘 및 Fluent 이모지), 읽기 시간 검사(ReadingTime), 음성 해설(Narration), 제작자 크레딧(ProducedBy)과 같은 믹스인을 제공하여 전문적인 결과물을 만듭니다. 사용자는 아이콘을 재사용하고, 일관된 모티프를 유지하며, 스토리텔링 방식으로 정보를 제시하는 스타일 가이드를 따라야 합니다. 최종 출력은 MP4, GIF 또는 PNG이며, T3 Code와 같은 인터페이스에서 인라인으로 표시하거나 절대 경로로 전달할 수 있습니다. 워크플로우는 출력 유형 선택, 예제 참조, 씬 작성, 저화질 드래프트 렌더링 및 검토, 고화질 최종 렌더링, 결과 전달의 6단계로 구성됩니다. 모든 반복은 최종 품질로 다시 렌더링하고 전달하는 것으로 마무리되어야 합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

title

문서

manim은(는) 무엇을 하나요?

설치 위치: Manim Community v0.22.1 (manim이 PATH에 있음, typst 추가 기능이 포함된 uv tool 설치), TeX Live와 dvisvgm(Tex/MathTex용), 그리고 Chatterbox Turbo(음성 해설용, ~/.local/opt/chatterbox 아래 자체 venv에 CPU 설치, narration.py로 구동). 씬 파일은 도구 자체의 Python에서 실행되며, 여기에는 numpy, scipy 및 networkx가 포함됩니다. 다른 import는 실패합니다. ManimCE API만 사용하세요. 3Blue1Brown의 manimgl은 별개의 라이브러리이므로, 이 라이브러리용으로 작성된 코드는 여기서 실행되지 않습니다.

스타일

Manim은 정보를 역동적이고 흥미로운 방식으로 제시하기 위한 도구입니다. 만약 당신이 만든 것이 순서도, 스프레드시트, 점 그래프 또는 슬라이드쇼로 쉽게 만들 수 있었다면, 당신은 manim을 올바르게 사용하고 있지 않은 것입니다. 아름다운 것이 더 매력적이고 더 기억에 남습니다. 전문 용어를 피하고, 프레젠테이션을 접근하기 쉽게 유지하세요. 모티프 세트를 정하고 일관되게 유지하세요. 개념은 일관된 시각적 표현을 가져야 합니다. 이야기를 들려주세요. 시작은 이야기의 중간에서 시작하세요. 아이디어와 문제를 기본 원리부터 소개하세요.

단계

  1. 출력 선택. 정적 그림(레이블이 있는 다이어그램, 플롯, 표 또는 수식)에는 정적 PNG를 사용하세요. 변화나 순서(단계별 유도, 움직이는 점, 변환)를 보여줄 때는 MP4를 사용하세요. GIF는 대상 플랫폼이 비디오를 재생할 수 없을 때만 사용하세요.

  2. 가장 가까운 예제 찾기. 아래 주제 파일을 열고 상단의 인덱스를 스캔하여 필요한 것과 가장 가까운 예제 1~3개를 읽으세요. 예제를 적용하여 씬을 구성하세요. 해당 예제들의 API 사용법은 이 버전에서 작동하는 것으로 확인되었습니다.

  3. 씬 작성 /tmp/manim/<slug>/scene.py에 (사용자가 다른 위치를 지정하지 않은 경우). 파일을 from manim import *로 시작하고 하나의 Scene 하위 클래스(MovingCameraScene / ThreeDScene / ZoomedScene – 예제에서 사용하는 경우)를 정의하세요.

    사물(구름, 서버, 자물쇠, 깃발, 사람, 문서)의 모든 그림은 이 스킬의 라이브러리에서 가져온 아이콘이며, 있는 그대로 사용합니다: icons.py를 씬 옆에 복사하고, 이 스킬의 디렉토리에서 grep -iw <word> assets/index.tsv로 id를 찾은 후(단어가 없으면 동의어 시도) icon(id, color=..., height=...)로 로드합니다. tabler/outline/* 및 tabler/filled/*는 color로 그려진 단색 선 및 채워진 아이콘(Tabler 아이콘)입니다. fluent/*는 자체 색상을 유지하는 풀컬러 이모지(Fluent Emoji, Flat 스타일)입니다. 다이어그램 구조만 Manim의 도형(상자, 화살표, 선, 축, 플롯, 레이블)을 사용하여 직접 그리세요. 각 개념에 하나의 아이콘을 할당하고 모티프 중 하나로 재사용하세요.

    텍스트를 표시하는 MP4 또는 GIF는 시청자에게 읽기 시간을 제공해야 하며, 검사기가 이를 강제합니다. reading_time.py를 씬 옆에 복사하고 from reading_time import ReadingTime으로 import한 후, 믹스인을 씬 기본 클래스 앞에 배치하세요: class SceneName(ReadingTime, Scene). 텍스트를 숨기거나, 교체하거나, 흐리게 하는 모든 play 앞에서 self.wait_to_read()를 호출하세요. 이 메서드는 각 보이는 텍스트가 화면에 1초 + 단어 수(150 wpm 기준)만큼 표시될 때까지 대기하며, 하나의 play로 드러난 모든 텍스트는 함께 읽힙니다. become() 대신 새로운 mobject(FadeIn, ReplacementTransform)로 새 단어를 표시하여 시간이 새로 시작되도록 하세요. 대기 중에도 모션은 계속 실행될 수 있습니다: 텍스트가 떠 있는 동안 재생되는 애니메이션 뒤에 self.wait_to_read()를 배치하세요.

    캡션으로 설명하는 MP4는 음성 해설됩니다: 음성이 텍스트를 읽어줍니다. narration.py를 씬 옆에 복사하고 ReadingTime 앞에 배치하세요: class SceneName(Narration, ReadingTime, Scene). self.speak(text)는 이전 줄이 끝날 때까지 기다렸다가 다음 줄을 시작하며, 그 뒤에 오는 애니메이션은 음성이 나오는 동안 재생됩니다. 음성이 읽는 캡션을 보여주는 play 바로 앞에 배치하세요. 캡션은 음성 줄을 단어 그대로 표시하며, 모든 음성 줄에는 캡션이 있습니다: 각 줄을 한 번 작성하고 동일한 문자열을 speak와 캡션의 Text에 전달하세요. 화면에 표시되는 것과 다르게 발음해야 하는 경우(예: "20"을 "twenty"로), 씬의 pronounce 딕셔너리에 추가하면 음성만 변경됩니다. 음성 해설 씬에서는 음성이 대기 시간을 설정합니다: 음성 줄이 말해지는 동안 나타나는 텍스트는 내레이터가 말을 마친 후 0.5초 멈춤까지 유지되어야 하며, self.wait_to_read()는 다음 변경 전까지 정확히 그 시간 동안 대기합니다(무음 중에 표시된 텍스트는 단어 수 규칙을 유지합니다). 음성은 차분한 남성 내레이터의 신경망 클론(Chatterbox Turbo)으로, 기술 다이어그램을 설명하는 데 최적화되었습니다. 각 새 줄은 음성 길이의 약 1~3배 시간이 합성에 소요되며(드래프트 스틸 포함), media/voice 아래에 캐시되므로 이후 렌더링에서는 변경한 줄만 음성 합성합니다. 각 줄은 읽히기 위한 것이지 읽기 위한 것이 아닙니다. API, TLS, HTTP와 같은 약어는 쓴 대로 잘 읽히며, narration.py는 숫자 뒤의 단위(200 ms), 점으로 구분된 버전(2.4.1) 및 k8s를 이미 발음 처리합니다. 다른 기계 문자열은 내레이터가 말하는 방식으로, 다시 pronounce를 통해 처리하세요: "2026.11.1711"이 아닌 "seventeen eleven". 경로와 브랜치 이름은 읽지 말고 설명하세요("an auto patches release branch"), 그리고 음성이 잘못 발음하는 단어는 씬의 pronounce 딕셔너리로 수정하세요({"edgeworker": "edge worker"}).

    모든 MP4 또는 GIF는 이를 만든 모델을 명명하는 크레딧 카드로 끝납니다. produced_by.py를 씬 옆에 복사하고 믹스인을 가장 먼저 배치하세요: class SceneName(ProducedBy, Narration, ReadingTime, Scene) (또는 텍스트가 없는 씬의 경우 class SceneName(ProducedBy, Scene)), 그리고 produced_by를 시스템 프롬프트가 알려주는 자신의 모델 이름으로 설정하세요 (produced_by = "Claude Opus 5.5"). 지침에 모델 이름이 없다면 사용자에게 물어보세요. 씬, 음성 해설 및 읽기 시간 검사가 완료되면 믹스인이 씬을 페이드 아웃하고 마지막 0.5초 동안 카드를 유지합니다. 정적 렌더링에서는 이를 건너<0xEB><0x9B><0x84>니다.

  4. 드래프트 및 확인. 저화질 스틸을 렌더링하고 PNG를 읽으세요:

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

    애니메이션의 경우 주요 순간도 확인하세요: -s -n 0,K는 애니메이션 K(0부터 시작, 각 self.play 및 self.wait가 하나씩 카운트) 이후에 중지하고 해당 프레임을 저장합니다. 프레임은 약 14.2 × 8 유닛이며 원점을 중심으로 합니다. 확인한 모든 프레임이 프레임 내에 모든 요소를 표시하고, 레이블이 겹치지 않으며, 텍스트를 읽을 수 있을 때까지 수정하고 다시 렌더링하세요.

    텍스트를 너무 빨리 제거하는 씬은 ReadingTimeError와 함께 실패하며, 각 텍스트, 나타난 시간, 표시된 시간 및 필요한 시간이 나열됩니다. 나열된 각 변경 전에 self.wait_to_read()를 추가하세요. 타이밍이 수정되기 전에 드래프트 프레임을 보려면 명령어 앞에 MANIM_READING_TIME=warn을 붙이세요. 최종 렌더링은 이것 없이 실행되며 통과해야 합니다.

  5. 최종 렌더링. -qm (720p30)을 사용하세요. 3D 씬은 Cairo 렌더러에서 느리므로 -ql로 드래프트하세요.

    manim render -qh --media_dir media -o final scene.py SceneName
    # -> media/videos/scene/1080p60/final.mp4   (GIF의 경우 --format gif 추가; PNG의 경우 -s를 사용하면 media/images/scene/final.png)
    
  6. 전달. 인터페이스가 미디어를 표시할 수 있을 때(명령어가 Markdown 이미지 구문이 이미지나 비디오를 임베드한다고 명시하는 경우, T3 Code의 경우) 출력을 인라인으로 표시하세요. 출력 파일을 세션의 작업 디렉토리로 복사한 다음, 절대 경로를 사용하여 거기서 임베드하세요 (![title](/abs/path/out.mp4); MP4와 PNG 모두 작동합니다). T3 Code는 작업 디렉토리에서만 미디어를 인라인으로 렌더링하므로 /tmp를 가리키는 임베드는 일반 링크로 표시됩니다. 일반 터미널과 같이 텍스트만 표시하는 인터페이스에서는 대신 출력 파일의 절대 경로를 제공하세요. 어느 쪽이든 씬 파일 경로도 제공하여 사용자가 수정할 수 있도록 하세요.

    모든 반복은 전달로 끝납니다. 씬을 변경할 때마다(사용자의 피드백 또는 자체 수정을 위해) 턴을 마무리하기 위해 세트의 모든 비디오를 최종 품질로 다시 렌더링하고(건드리지 않은 것까지) 각각을 6단계와 같이 전달하세요. 스틸과 프레임 캡처는 작업 확인에 도움이 되지만 비디오를 대체하지는 않습니다. 각 라운드마다 고유한 파일 이름을 사용하세요 (<name>-v2.mp4, <name>-v3.mp4). 이전 메시지가 설명한 버전을 계속 표시할 수 있도록 하기 위함입니다.

주제 파일

각 파일은 파일에 달리 명시되지 않는 한 v0.22.1 문서에서 그대로 가져온 렌더 테스트된 예제를 보유하며, 상단에 인덱스가 있습니다.

  • references/basics.md: 위치 지정, 스타일링, 그룹화/배치, .animate, Transform, 사용자 정의 애니메이션.
  • references/text-and-math.md: Text/MarkupText, Tex/MathTex, Typst 수학, 수식 부분 색칠, 방정식 재배열, 글머리 기호 목록, 제목, 코드 블록, 중괄호, 실시간 숫자.
  • references/plots-and-axes.md: Axes 플롯, 영역 및 리만 합, 도함수/할선, 음함수/매개변수/극곡선, 로그 축, 데이터 선 그래프, 수직선과 평면, 복소 평면, 막대 차트.
  • references/diagrams-and-geometry.md: 화살표, 레이블이 있는 선/점/도형, 각도, 직각, 강조(둘러싸는 상자, 밑줄, 십자), 벤/부울 도형, 다각형, 점선 윤곽선.
  • references/code.md: 구문 강조 코드: 입력, 줄 강조, 토큰 선택, 한 버전에서 다음 버전으로 변형.
  • references/graphs-tables-matrices.md: 노드-링크 Graph/DiGraph, 트리, 신경망 계층, networkx 가져오기, 레이아웃 변경, 표, 행렬, 행렬식, 평면의 선형 변환.
  • references/animation-and-motion.md: 업데이터, ValueTracker, always_redraw, 추적 경로, 변환 변형, MoveToTarget/Restore, Succession/LaggedStart 타이밍, 강조(Indicate, Circumscribe, Flash), 성장/페이드 인트로, 속도 함수.
  • references/camera-3d-fields.md: 카메라 이동/확대/축소, 확대 삽입, ThreeDScene 카메라 제어, 3D 표면 및 곡선, 벡터장 및 흐름선.
  • references/complete-scenes.md: 다단계 설명의 속도를 보여주는 두 개의 더 긴 씬.

API 조회

전체 독스트링이 포함된 설치된 소스는 ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/에 있습니다. 키워드 인자를 추측하기 전에 클래스나 메서드의 시그니처와 옵션을 grep하세요.

주의사항

  • LaTeX 문자열은 raw 문자열로 작성하세요 (r"\frac{a}{b}"). LaTeX 오류는 .tex 로그를 출력하며, 문제가 있는 줄은 대개 끝 부분에 있습니다.
  • xelatex는 설치되어 있지 않으므로, 이를 필요로 하는 TexTemplateLibrary 템플릿(예: ctex)은 실패합니다. CJK 텍스트는 Text/MarkupText를 사용하세요. 이들은 Pango를 통해 시스템 글꼴로 렌더링됩니다(fc-list로 확인 가능).
  • Typst / MathTypst는 Tex / MathTex보다 빠른 대안이며 LaTeX가 필요 없습니다.
  • icon()으로 아이콘을 로드하면 Tabler 아이콘의 색상이 다시 지정됩니다. 해당 파일은 currentColor로 그려지며, 일반 SVGMobject는 검은색으로 읽습니다.
  • 검은색으로 그려진 Fluent 아이콘(fluent/black-flag, fluent/black-cat)은 검은 배경에서 사라집니다. 다른 아이콘을 선택하거나 밝은 도형 위에 설정하세요.
  • Tabler 선 아이콘은 tabler/outline/server의 표시등과 같이 길이가 0인 선으로 그려진 점을 잃습니다.

관련 스킬