API ВЕГА

Генерирует из одного изображения pet.json и spritesheet.webp для пользовательского Codex Pet. Создаёт спрайт-лист формата 1536×1872 с 9 состояниями анимации: один вызов GPT Image 2 через RunComfy CLI, затем сборка кадров с помощью ImageMagick.

Возможности

  • Преобразует исходное изображение в chibi-персонажа с прозрачным фоном.
  • Собирает атлас из ячеек 192×208: 8 столбцов и 9 строк.
  • Создаёт анимацию программно: смещения на 1–2 px, моргание, повороты и зеркальное отражение.
  • Записывает pet.json и устанавливает оба файла в ${CODEX_HOME:-$HOME/.codex}/pets/<name>/.
  • Для работы нужны RunComfy CLI, ImageMagick и RUNCOMFY_TOKEN. Codex Pro, $imagegen и OPENAI_API_KEY не нужны.

Когда использовать

  • Нужно сделать пользовательского Codex Pet по ссылке на изображение.
  • Нужно сгенерировать несколько питомцев из набора исходных изображений.
  • Нет Codex Pro или доступа к $imagegen, но есть аккаунт RunComfy.
  • Нужно подготовить spritesheet.webp и pet.json для локальной установки в Codex.

Установка

npx skills add agentspace-so/runcomfy-agent-skills --skill codex-pet -g

Примеры

Вызов GPT Image 2 для генерации канонического спрайта:

runcomfy run openai/gpt-image-2/edit \
  --input "{\"prompt\": \"Generate one canonical Codex digital pet sprite based on the input image.\", \"images\": [\"${SOURCE_URL}\"], \"size\": \"1024*1024\"}" \
  --output-dir "${RUN_DIR}/decoded/"

Манифест pet.json:

{
  "id": "my-pet",
  "displayName": "my-pet",
  "description": "A friendly companion for late-night refactors.",
  "spritesheetPath": "spritesheet.webp"
}

Установка готового питомца:

DEST="${CODEX_HOME:-$HOME/.codex}/pets/${PET_NAME}"
mkdir -p "${DEST}"
cp "${RUN_DIR}/pet.json" "${RUN_DIR}/spritesheet.webp" "${DEST}/"

Установка

npx skills add https://github.com/prime-skills/runcomfy-agent-skills --skill codex-pet