manim (ManimGL) 딥다이브
— 3Blue1Brown이 수학 영상을 만드는 프로그래밍 애니메이션 엔진

1프로젝트 한 줄 요약

manim(math + animation)은 "설명용 수학 영상을 위한, 정밀한 프로그래밍 애니메이션 엔진"이다. 사용자는 Scene이라는 클래스를 상속받아 construct() 메서드 안에 "무엇을, 어떻게 움직여라"를 파이썬으로 적는다. 그러면 manim이 그 지시를 매 프레임의 좌표·색·투명도로 계산(보간)해 GPU로 그리고, ffmpeg로 mp4 영상까지 뽑아준다.

이 저장소가 특별한 이유는 두 개의 manim이 존재하기 때문이다. 지금 보는 3b1b/manim은 Grant Sanderson 본인이 자기 영상 제작을 위해 쓰는 "원조" 버전(패키지명 manimgl)이고, 2020년 커뮤니티가 이를 포크해 만든 안정판이 따로 있다(패키지명 manim). 이 구분은 뒤(2절)에서 자세히 다룬다 — 설치 사고의 90%가 여기서 난다.

2왜 지금 주목받는가

manim은 신생 프로젝트가 아니다. 그런데도 TrendShift 상위권에 다시 오른다. 핵심은 유명한 원조 저장소가 2026년 들어 렌더링 엔진을 OpenGL에서 wgpu(WebGPU)로 통째 교체하는 대공사를 진행 중이기 때문이다. 관심 포인트는 세 가지다.

① 3Blue1Brown이라는 브랜드 자체

선형대수·미적분·신경망을 시각적으로 설명하는 3Blue1Brown 영상을 한 번쯤 본 사람은 수백만 명이다. "그 영상을 만드는 도구가 오픈소스"라는 사실은 그 자체로 강력한 유입 동기다. 개발자·교사·학생이 "나도 저런 영상을 만들고 싶다"며 계속 몰려든다.

② 렌더러 현대화: OpenGL → wgpu / WebGPU

초기 manim은 CPU에서 Cairo로 그림을 그렸고, 이후 ManimGL이라는 이름대로 OpenGL(ModernGL) 기반 GPU 렌더링으로 넘어갔다. 그리고 최신판(1.7.x)은 다시 wgpu로 이주했다. wgpu는 브라우저 표준 WebGPU의 파이썬 구현으로, 하나의 코드가 내부적으로 Vulkan·Metal·DirectX12·OpenGL 중 그 컴퓨터에 맞는 API로 실행된다. 셰이더도 GLSL이 아니라 WGSL(.wgsl)로 다시 쓰였다.

③ "코드를 고치며 실시간으로 보는" 대화형 워크플로우

ManimGL의 킬러 기능은 Scene.embed()다. 이걸 넣고 실행하면 렌더링 창이 뜬 채로 IPython 셸이 열려, 화면 속 도형을 그 자리에서 코드로 밀고·돌리고·바꿔 볼 수 있다. 영상 한 편을 통째로 렌더링해 결과를 확인하는 게 아니라, 라이브로 조각하듯 만든다. 이 실시간성이 커뮤니티판과 구별되는 원조판의 매력이다.

3기술 스택 전체 지도

manim의 의존성 목록을 뜯어보면 이 프로젝트의 정체가 그대로 드러난다. 수학을 계산하는 층(numpy·scipy·sympy), 그것을 GPU로 그리는 층(wgpu·WGSL), 그리고 텍스트·수식·영상으로 내보내는 미디어 층이 한 몸으로 묶여 있다.

수학 · 데이터 코어

GPU 렌더링 층 (이 저장소의 심장)

텍스트 · 수식 · 미디어 파이프라인

4아키텍처 심화 분석

전체 실행 흐름

manimgl my_scene.py MyScene를 치면 벌어지는 일을 그리면 이렇다.

3대 핵심 추상

manim의 모든 것은 세 개의 클래스로 환원된다. 이 셋의 관계만 잡으면 나머지는 응용이다.

Mobject — 데이터가 곧 도형

Mobject(math object)는 세 가지를 들고 있다. ① self.data: 점마다의 좌표·색을 담은 numpy StructuredArray(이게 통째로 GPU 버퍼로 올라간다). ② self.uniforms: 셰이더에 넘길 개체별 설정(음영 등). ③ self.submobjects: 자식 Mobject들의 리스트. 도형은 트리(가족) 구조다 — 하나의 수식은 여러 글자 Mobject의 부모이고, 각 글자는 다시 획들의 부모다.

class Mobject:
    def __init__(self, ...):
        self.submobjects = []            # 자식들 (가족 트리)
        self.data = StructuredArray(...) # 점: point/color 등 -> GPU 버퍼
        self.uniforms = Uniforms(...)    # 개체별 셰이더 설정

    def get_family(self):                # 나 + 모든 자손을 평탄화
        return [self, *sub_families...]

대부분의 도형은 VMobject(Vectorized Mobject)를 상속한다. 곡선을 베지어 곡선의 연쇄로 표현하는 벡터 도형이다. 그래서 아무리 확대해도 계단현상이 없다.

렌더링 — 스텐실 버퍼로 "면"을 채운다

manim의 렌더러(renderer/)에서 가장 배울 게 많은 지점은 임의의 곡선으로 둘러싸인 면을 GPU 스텐실 버퍼의 감김수(winding number)로 채우는 기법이다(fill.wgsl). CPU에서 다각형을 삼각형으로 쪼개는(triangulation) 대신, 각 베지어가 만드는 삼각형들을 GPU에 그리되 "픽셀을 몇 번 감쌌는가"를 스텐실에 세어 내부/외부를 판정한다.

Animation — alpha와 rate_func

애니메이션의 심장은 단 하나, interpolate(alpha)다. alpha는 0(시작)에서 1(끝)로 가는 진행도다. 엔진은 매 프레임 경과 시간을 alpha로 바꾸고, 여기에 rate_func(기본 smooth)를 씌워 "처음엔 천천히, 중간엔 빠르게, 끝엔 다시 천천히"의 자연스러운 가감속을 만든다.

alpha (선형 시간) ─► rate_func ─► 실제 진행도
  play(Transform(A, B), run_time=3, rate_func=smooth)
  # 매 프레임: A.data 를 B.data 쪽으로 rate_func(alpha) 만큼 보간

5디렉토리 구조 해부

구조를 관통하는 원칙은 "무엇(mobject) / 어떻게(animation) / 언제(scene)"의 3분할이다. 새 도형을 배우려면 mobject/를, 새 효과를 배우려면 animation/을, 출력·연출을 배우려면 scene/을 열면 된다.

6학습 포인트

manim을 뜯어보면 겉보기(수학 영상)와 달리, GPU 그래픽스·씬 그래프·수치 보간·미디어 파이프라인이라는 서로 다른 분야를 실전 코드로 한 번에 배울 수 있다. 배울 거리를 층별로 정리하면 이렇다.

① GPU 그래픽스 파이프라인

renderer/와 shaders/는 현대 GPU 프로그래밍의 압축판이다. 정점 버퍼, 유니폼, 파이프라인 상태(깊이·스텐실·블렌드), 그리고 WGSL 셰이더까지. 특히 스텐실 감김수로 벡터 면을 채우는 기법은 실무 벡터 렌더러(폰트·SVG 엔진)에서도 쓰는 고급 주제다.

② 씬 그래프 / 트리 자료구조

Mobject.submobjects와 get_family()는 게임 엔진·UI 프레임워크의 씬 그래프와 똑같은 개념이다. 부모를 옮기면 자식이 따라오고, 변환이 트리를 타고 전파된다. 재귀적 트리 순회를 실제 쓰임새로 익히기 좋다.

③ 수치 보간과 이징(easing)

utils/rate_functions.py와 utils/bezier.py는 애니메이션의 수학이다. 선형 시간을 자연스러운 움직임으로 바꾸는 rate function, 곡선을 표현하는 베지어 보간 — 프론트엔드 CSS 애니메이션부터 게임까지 어디서나 재등장하는 개념이다.

④ 외부 도구 오케스트레이션

LaTeX을 호출해 SVG를 얻고, ffmpeg에 프레임을 파이프로 흘려보내는 scene_file_writer.py는 "파이썬으로 외부 프로세스를 지휘하는 법"의 좋은 예다. subprocess.Popen으로 스트리밍 인코딩을 붙이는 실전 패턴을 볼 수 있다.

7하드웨어 / 시스템 요구사항

manim은 무거운 학습 프레임워크가 아니라 렌더링 엔진이라, 최신 GPU가 없어도 돈다. 다만 파이썬 밖의 외부 도구 두세 개를 시스템에 깔아야 하고, 초보자 설치 실패의 대부분이 이 단계에서 난다.

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

10핵심 키워드 사전

11참고 링크