aldegad/sprite-gen

这是什么？

核心功能

• 01基于一张基础图逐行生成各状态动画，并保持角色外观一致。
• 02将色键背景转换为真实透明通道，提取干净的透明帧。
• 03输出运行时图集及 manifest.json，记录帧矩形、帧率和循环标记。
• 04利用视频模型为每个动作状态生成透明循环动画。
• 05提供校对网页，可在合成前审阅、微调和预览帧。
• 06支持确定性重新配色，并导出 Aseprite JSON 供 Phaser、Flame 等引擎使用。

适用场景

• 将一张角色插画扩展为 2D 游戏所需的待机、行走、攻击、跳跃等完整精灵动画。
• 用视频模型从单张静态图生成透明循环动画。
• 将现有精灵图集重新配色，生成多套色彩变体。
• 通过 Aseprite JSON 将精灵图集导出到 Phaser 或 Flame。

快速上手

1. 1

   创建并激活 Python 虚拟环境

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

   以可编辑模式安装 sprite-gen

   pip install -e .
3. 3

   检查命令行工具是否可以运行

   sprite-gen --help

使用前须知

• !图像和视频生成需要你自己的 Codex 或 Grok 订阅登录，或 XAI_API_KEY 等 API 密钥。
• !视频循环还需要另外安装 ffmpeg 和 img2webp。
• !除非动作质检通过，行走和奔跑循环仍属实验性功能；方向校正需手动开启，且结果可能出错。

收录于专题

标签

常见问题

sprite-gen 是什么？

Codex/Claude 技能与 Python CLI，把一张角色图转为可直接用于游戏的 2D 精灵图集或透明动画循环。 sprite-gen 针对 AI 绘图模型的一个常见问题：要求生成精灵图时，角色往往每一帧外观都在变，背景抠不干净，输出的 PNG 也无法直接被游戏引擎使用。它从一张基础图出发，逐行生成各个动画状态，同时保持角色一致，将色键背景去除为真实透明通道，并把每个姿势提取为透明帧。

sprite-gen 可以免费使用吗？用的什么许可证？

sprite-gen 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

sprite-gen 还在维护吗？

活跃维护中。sprite-gen 最近一次提交是在 2026年11月6日。

sprite-gen 适合用来做什么？

将一张角色插画扩展为 2D 游戏所需的待机、行走、攻击、跳跃等完整精灵动画。 用视频模型从单张静态图生成透明循环动画。 将现有精灵图集重新配色，生成多套色彩变体。 通过 Aseprite JSON 将精灵图集导出到 Phaser 或 Flame。

sprite-gen 怎么安装和运行？

创建并激活 Python 虚拟环境: python3 -m venv .venv && source .venv/bin/activate 以可编辑模式安装 sprite-gen: pip install -e . 检查命令行工具是否可以运行: sprite-gen --help

在哪里获取 sprite-gen？

源代码和安装说明在 GitHub 上：https://github.com/aldegad/sprite-gen