Science-Prof-Robot/recursive-math-animator

recursive-math-animator은(는) 무엇을 하나요?

Cursor 및 Claude Code 스킬: Manim 애니메이션, manim-voiceover, Git 기반 장면 버전 관리, 선택적 Gemini TTS

개요

이 스킬은 Manim(Mathematical Animation Engine)을 활용하여 3Blue1Brown 스타일의 수학 애니메이션을 생성하고, manim-voiceover를 통해 음성 해설을 추가하며, Git을 사용해 장면 버전을 관리할 수 있도록 지원합니다. 선택적으로 Google Gemini TTS를 음성 생성 엔진으로 사용할 수 있습니다.

주요 기능

• Manim 애니메이션 생성: Python 코드로 정밀한 수학 애니메이션 제작
• manim-voiceover 통합: 자동 음성 해설 생성 및 동기화
• Git 기반 버전 관리: 각 장면의 변경 사항을 커밋하고 복원
• 선택적 Gemini TTS: 고품질 음성 출력 지원

설치 방법

1. 저장소 클론:

git clone https://github.com/Science-Prof-Robot/recursive-math-animator.git
cd recursive-math-animator

2. Python 가상 환경 생성 및 활성화:

python3 -m venv .venv
source .venv/bin/activate  # Linux/Mac
# 또는 .venv\Scripts\activate  # Windows

3. 의존성 설치:

pip install -r requirements.txt

4. (선택 사항) Gemini TTS 사용을 위한 환경 변수 설정:

export GEMINI_API_KEY="your-api-key-here"

사용법

기본 애니메이션 생성

from manim import *

class SquareToCircle(Scene):
    def construct(self):
        circle = Circle()
        square = Square()
        self.play(Create(square))
        self.play(Transform(square, circle))
        self.wait()

음성 해설 포함

from manim_voiceover import VoiceoverScene
from manim_voiceover.services.gemini import GeminiService

class VoiceoverExample(VoiceoverScene):
    def construct(self):
        self.set_speech_service(GeminiService())
        with self.voiceover("이것은 원입니다.") as tracker:
            circle = Circle()
            self.play(Create(circle))

Git 버전 관리

git add scenes/voiceover_example.py
git commit -m "음성 해설 추가: 원 애니메이션"

환경 변수

변수명	설명	필수 여부
GEMINI_API_KEY	Gemini TTS API 키	선택
MANIM_VOICEOVER_ENGINE	사용할 TTS 엔진 (기본값: gTTS)	선택

지원 플랫폼

• Cursor
• Claude Code
• 기타 Manim 호환 Python 환경

라이선스

MIT License