Английский | 中

Локальный навык агента для превращения предоставленного пользователем или созданного ImageGen изображения персонажа в короткое видео действия, кадры анимации PNG и лист спрайта.

Включенный провайдер настраивается через общий адаптер API от изображения к видео. Ключи API считываются только из переменных среды.

Быстрый старт

Требования: Python 3.10+

• FFmpeg доступен на PATH
• Подушка
• Пиямль
• просьбы

Установите зависимости от Python:

Конфигурация копии:

Установите ключ API видео в среде оболочки. Не вставляйте секреты в исходный код или не совершайте [T0].

Вы можете начать с любого:

• существующее изображение персонажа, предоставленное пользователем; или
• новый символ, созданный с помощью ImageGen в Codex.

Для генерируемых ссылок создайте один полный 2D-персонаж на простом или прозрачном фоне, а затем используйте это изображение в качестве входа --image.

Поставщик должен реализовать:

После настройки:

Прочитайте SKILL.md для рабочего процесса Агента и поведения первой настройки.

Пример

Этот репозиторий включает в себя один авторизованный пример:

• [[Т3]]: исходный текст. 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.