한국어 |

User-supplied 또는 ImageGen-created 문자 참조 이미지를 짧은 액션 비디오, PNG 애니메이션 프레임 및 스프라이트 시트로 전환하기위한 로컬 에이전트 기술.

포함된 공급자는 일반적인 이미지에 영상 API 접합기를 통해서 형성됩니다. API 키는 환경 변수에서만 읽습니다.

빠른 시작

명세서:

• 파이썬 3.10+
• PATH에서 유효한 FFmpeg
• 베개
• 피야ML
• 요청

Python 의존성 설치:

복사 구성:

쉘 환경에서 비디오 API 키를 설정합니다. 소스 코드로 비밀을 풀거나 .env]를 커밋하지 마십시오.

당신은에서 시작할 수 있습니다:

• 사용자가 제공하는 기존 문자 이미지; 또는
• Codex 내부 ImageGen으로 생성 된 새로운 문자 참조.

생성된 참조를 위해, 간단한 투명 배경에 단일 전체 바디 2D 문자를 만들고, 그 이미지를 --image 입력으로 사용합니다.

공급자는 실행해야 합니다:

설정 한 번:

SKILL.md] 에이전트 워크플로우 및 첫 번째 실행 설정 동작을 읽으십시오.

예

이 저장소에는 1개의 허가한 예가 있습니다:

• examples/chara.png: 소스 문자 시트.
• examples/reference_frame.png: 이미지에 비디오에 사용되는 첫 번째 프레임을 자르기.

Character Animation Skill

English | 简体中文

A local Agent skill for turning a user-supplied or ImageGen-created character reference image into a short action video, PNG animation frames, and a sprite sheet.

The included provider is configured through a generic image-to-video API adapter. API keys are read from environment variables only.

Quick start

Requirements:

• Python 3.10+
• FFmpeg available on PATH
• Pillow
• PyYAML
• requests

Install Python dependencies:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Copy configuration:

cp config.example.yaml config.yaml
cp .env.example .env

Set your video API key in the shell environment. Do not paste secrets into source code or commit .env.

export VIDEO_API_KEY="your-api-key"

You can start from either:

• an existing character image supplied by the user; or
• a new character reference generated with ImageGen inside Codex.

For generated references, create a single full-body 2D character on a simple or transparent background, then use that image as the --image input.

The provider must implement:

generate(image_path, prompt, duration, output_path) -> local_video_path

Once configured:

python scripts/generate_video.py --image character.png --action "walk" --duration 4 --loop --output output/source.mp4
python scripts/extract_frames.py --video output/source.mp4 --output-dir output/raw_frames --fps 8
python scripts/align_frames.py --input-dir output/raw_frames --output-dir output/frames
python scripts/build_spritesheet.py --input-dir output/frames --output output/spritesheet.png

Read SKILL.md for the Agent workflow and first-run setup behavior.

Example

This repository includes one authorized example:

• examples/chara.png: source character sheet.
• examples/reference_frame.png: cropped first frame used for image-to-video.
• examples/source_4s.mp4: generated 4-second source video.
• examples/spritesheet_8frames.png: compact 8-frame transparent sprite sheet.
• examples/walk_cycle_8frames_preview.gif: animated preview.

Generated working files should stay under output/, which is ignored by Git.