Repolode
yokel1121

yokel1121/muyang-flat-animation

Gemini로 중국어 대사나 추상적인 아이디어를 펜 선 스케치 설명 애니메이션 에셋으로 만드는 Codex Skill입니다.

스타
287
포크
39
열린 이슈
0
마지막 커밋
3개월 전

어떤 프로젝트인가요?

Muyang Flat Animation은 종이 질감이 살아 있는 펜 선화와 필요한 부분만 색연필로 채색한 손그림 스타일의 짧은 설명 영상을 제작하는 Codex Skill입니다. 중국어 문장이나 의견, 추상적인 개념을 입력하면 세 단계로 영상을 만듭니다. 먼저 시각적 콘셉트와 구도, 움직임 계획을 확인하고, 다음으로 최종 스틸 프레임을 생성해 승인한 뒤, 마지막으로 Gemini video API를 호출해 결과를 프레임별로 확인하고 오디오도 검사합니다.

인물이 등장하는 내레이션 영상과 인물 없이 콘텐츠만 시각화하는 영상 모두 지원하며, 9:16이나 16:9 같은 사용자 지정 캔버스 크기, 의미에 맞춘 여러 색상 팔레트, 동기화된 가벼운 효과음 또는 무음 출력을 선택할 수 있습니다. 저장소에는 독립 실행형 일괄 동영상 생성 스크립트와 카메라 흔들림, 캐릭터와 손의 일관성, 스타일 변화, 출력 사양을 확인하는 검사 스크립트도 포함되어 있습니다. 사용하려면 Python 3.10 이상, FFmpeg, FFprobe, Gemini API 키가 필요합니다.

핵심 기능

  • 01필요한 부분만 색연필로 채색하는 펜 선 스케치 스타일의 설명 영상을 생성합니다.
  • 02인물 내레이션과 인물 없는 콘텐츠 시각화를 모두 지원합니다.
  • 039:16, 16:9, 3:4, 4:5, 1:1 또는 사용자 지정 픽셀 크기의 캔버스를 지원합니다.
  • 04의미에 따른 자동 색상, 내장 프리셋 또는 사용자 지정 색상 값을 사용할 수 있습니다.
  • 05동기화된 가벼운 효과음을 추가하거나 무음 영상을 출력합니다.
  • 06일괄 동영상 생성기와 프레임 및 오디오를 확인하는 QA 스크립트를 제공합니다.

활용 사례

  • 소셜 미디어나 강의용 지식 설명 숏폼 영상을 제작합니다.
  • 추상적인 아이디어 하나를 발표용 스케치 애니메이션으로 시각화합니다.
  • 일관된 손그림 스타일로 숏폼 플랫폼용 세로형 9:16 영상을 제작합니다.

빠른 시작

  1. 1

    리포지토리를 클론합니다

    git clone https://github.com/yokel1121/muyang-flat-animation.git
  2. 2

    Python 종속성을 설치합니다

    pip install -r muyang-flat-animation/requirements.txt
  3. 3

    Skill 폴더를 Codex Skills 디렉터리에 복사합니다(macOS/Linux)

    cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation
  4. 4

    설정을 확인합니다

    python ~/.codex/skills/muyang-flat-animation/scripts/check_setup.py

사용 전 알아둘 점

  • Gemini API 키가 필요하며 FFmpeg와 FFprobe는 별도로 설치해야 합니다.
  • 동영상 생성은 Gemini 모델 이름, 리전, 할당량 및 요금에 따라 달라지며, 이러한 조건은 변경될 수 있습니다. 사용량이 제한된 키에서는 429 오류가 자주 발생합니다.
  • 연필이나 종이 마찰음이 포함되어 있는지 확인하려면 여전히 직접 들어봐야 합니다.

토픽

자주 묻는 질문

muyang-flat-animation은(는) 무엇인가요?
Gemini로 중국어 대사나 추상적인 아이디어를 펜 선 스케치 설명 애니메이션 에셋으로 만드는 Codex Skill입니다. Muyang Flat Animation은 종이 질감이 살아 있는 펜 선화와 필요한 부분만 색연필로 채색한 손그림 스타일의 짧은 설명 영상을 제작하는 Codex Skill입니다. 중국어 문장이나 의견, 추상적인 개념을 입력하면 세 단계로 영상을 만듭니다. 먼저 시각적 콘셉트와 구도, 움직임 계획을 확인하고, 다음으로 최종 스틸 프레임을 생성해 승인한 뒤, 마지막으로 Gemini video API를 호출해 결과를 프레임별로 확인하고 오디오도 검사합니다.
muyang-flat-animation은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
muyang-flat-animation은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
muyang-flat-animation은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. muyang-flat-animation의 마지막 커밋은 2026년 7월 22일입니다.
muyang-flat-animation은(는) 어디에 사용할 수 있나요?
소셜 미디어나 강의용 지식 설명 숏폼 영상을 제작합니다. 추상적인 아이디어 하나를 발표용 스케치 애니메이션으로 시각화합니다. 일관된 손그림 스타일로 숏폼 플랫폼용 세로형 9:16 영상을 제작합니다.
muyang-flat-animation는 어떻게 설치하나요?
리포지토리를 클론합니다: git clone https://github.com/yokel1121/muyang-flat-animation.git Python 종속성을 설치합니다: pip install -r muyang-flat-animation/requirements.txt Skill 폴더를 Codex Skills 디렉터리에 복사합니다(macOS/Linux): cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation 설정을 확인합니다: python ~/.codex/skills/muyang-flat-animation/scripts/check_setup.py
muyang-flat-animation은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yokel1121/muyang-flat-animation

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트