aldegad/sprite-gen

Что это?

Ключевые возможности

• 01Создаёт состояния спрайта построчно на основе одного исходного изображения, сохраняя единообразие персонажа.
• 02Преобразует хромакей-фон в настоящую альфа-канальную прозрачность и извлекает чистые прозрачные кадры.
• 03Создаёт атлас для использования во время выполнения и manifest.json со списком координат кадров, значениями fps и флагами зацикливания.
• 04Создаёт прозрачные циклические анимации с помощью видеомоделей — по одной на каждое состояние движения.
• 05Предоставляет webview для отбора материалов: кадры можно просматривать, корректировать и предварительно оценивать перед сборкой.
• 06Поддерживает перекрашивание и экспорт в Aseprite JSON для таких движков, как Phaser и Flame.

Сценарии использования

• Преобразование одной иллюстрации персонажа в полный набор спрайтов для состояний покоя, ходьбы, атаки и прыжка в 2D-игре.
• Создание прозрачных циклических анимаций на основе одного изображения с помощью видеомодели.
• Перекрашивание существующего листа спрайтов в несколько вариантов палитры.
• Экспорт атласов спрайтов для Phaser или Flame через Aseprite JSON.

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

1. 1

   Создайте и активируйте виртуальное окружение Python

   python3 -m venv .venv && source .venv/bin/activate
2. 2

   Установите sprite-gen в редактируемом режиме

   pip install -e .
3. 3

   Убедитесь, что CLI запускается

   sprite-gen --help

Что важно знать

• !Для генерации изображений и видео нужно войти в аккаунт с подпиской Codex или Grok либо использовать API-ключ, например XAI_API_KEY.
• !Для создания видеопетель также нужно отдельно установить ffmpeg и img2webp.
• !Петли ходьбы и бега считаются экспериментальными, если они не проходят motion QA. Коррекция направления включается по желанию и может работать неправильно.

В подборках

Темы

Частые вопросы

Что такое sprite-gen?

Навык Codex/Claude и Python CLI, который превращает одно исходное изображение в готовые для игры 2D-атласы спрайтов или прозрачные циклические анимации. sprite-gen решает распространённую проблему генерации изображений с помощью AI-моделей: если попросить создать лист спрайтов, внешний вид персонажа часто меняется от кадра к кадру, фон удаляется с артефактами, а PNG нельзя напрямую использовать в игровых движках. Инструмент берёт одно исходное изображение, генерирует каждое состояние анимации построчно, сохраняя единообразие персонажа, удаляет хромакей-фон и создаёт настоящую альфа-канальную прозрачность, а затем извлекает каждую позу в отдельный прозрачный кадр.

sprite-gen можно использовать бесплатно? Какая у него лицензия?

sprite-gen распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

sprite-gen всё ещё поддерживается?

Активно поддерживается. Последний коммит в sprite-gen — 6 нояб. 2026 г..

Для чего можно использовать sprite-gen?

Преобразование одной иллюстрации персонажа в полный набор спрайтов для состояний покоя, ходьбы, атаки и прыжка в 2D-игре. Создание прозрачных циклических анимаций на основе одного изображения с помощью видеомодели. Перекрашивание существующего листа спрайтов в несколько вариантов палитры. Экспорт атласов спрайтов для Phaser или Flame через Aseprite JSON.

Как установить sprite-gen?

Создайте и активируйте виртуальное окружение Python: python3 -m venv .venv && source .venv/bin/activate Установите sprite-gen в редактируемом режиме: pip install -e . Убедитесь, что CLI запускается: sprite-gen --help

Где скачать sprite-gen?

Исходный код и инструкции по установке — на GitHub: https://github.com/aldegad/sprite-gen