0x0funky/agent-sprite-forge
0x0funky/agent-sprite-forge has 5,351 GitHub stars and 520 forks. GitHot measured +45 stars in 24 hours. Last checked 2026-11-07 14:53 UTC. Last push 2026-10-06.
Agent Skill for generating 2D sprite sheets and map, transparent PNG frames, and animated GIFs from prompts.
实测星标增长
- 24小时
- +45
- 7天
- 更新延迟
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
README.zh-CN.md
原文Agent Sprite Forge
语言：English | 繁體中文 | 简体中文 | 日本語 | 한국어
0.4 宣传预告：每一帧都是 ASF 的真实输出。
本页是与英文版同步的摘要。完整说明以 English README 为准（繁體中文为完整翻译）。
一张原画 → 整套可进游戏的 sprite
面向 Claude Code（插件）、Codex 与 Grok 的 agent 技能。Agent 用你手上最好的生图路径做出一张原画（master still），再从这张原画为每个动作各生成一段图生视频（image-to-video），然后由确定性的 Python 工具逐一把关、抠图、对位、挑循环、重新计时、后期处理（finish）并打包，交给 Godot、Aseprite 或网页游戏。
一张原画（本机 Codex CLI 生成）→ 每个动作一段 Grok 图生视频 → 六个动作。每一帧都来自 2026-10-06 的实机运行。
0.4 新功能：大升级
| 实机测量 | 升级前 | 0.4 |
|---|---|---|
| 像素狐狸（48x64，8 帧）：每帧颜色数 | 594–709 | 16–19 |
| 像素狐狸：alpha 阶数 / 每帧孤立像素（平均） | 199 / 732 | 2 / 75 |
| 抠图：紫边（外圈溢色，平均） | 0.704 | 0 |
| 抠图：145 帧中漏出的 key 像素 / 用时 | 7,780 / 271 秒 | 0 / 44 秒 |
| 攻击：单次动作长度 | 4.1 秒 | 0.7 秒 |
| 颜色锁定：每对相邻帧的色相翻转（跑步循环） | 352 | 170 |
| QC：被误判淘汰的好 take | 24 段中 18 段 | 24 段中 0 段 |
- 生图优先： 所有图片和视频都经过
route_media.py：已配置的 API key（OpenAI、Google Gemini、xAI、BytePlus、fal.ai）→ 你已登录的本机 Codex / Grok CLI → 最后才是代码绘制（codeart2d）。 - 一张原画：
master_still.py生成候选、用编辑修正、核准为master.json。 - 整套动作：
sprite_set.py为每个动作生成一段视频，自动 QC 与重拍、soft matte 抠图（无紫边）、对位、自动挑循环、单次动作自动重新计时、HD 颜色锁定，默认 HD 后期，可选清晰的像素后期，并导出引擎文件。 - 引擎导出： animation.json 3.0、PNG atlas、WebM alpha、packed MP4；Godot SpriteFrames / Sprite3D；Aseprite JSON；地图导出 Tiled、Godot、LDtk。
前后对比图与完整说明：What's new、CHANGELOG、实机记录。
快速开始
安装。 Claude Code：
claude plugin marketplace add 0x0funky/agent-sprite-forge --sparse .claude-plugin skills claude plugin install agent-sprite-forge@agent-sprite-forge python -m pip install "numpy>=1.26" "Pillow>=10.1" "scipy>=1.11"Codex / Grok：
git clone https://github.com/0x0funky/agent-sprite-forge.git，python -m pip install -r requirements.txt，然后python tools/install_skills.py --apply --host codex（Grok 用--host grok）。视频需要 ffmpeg 5.1+。原画：
Use $generate2dsprite to make a master still of <你的角色>, side view, facing right, HD.整套动作：
Use $video2dsprite to animate the approved master: idle, walk, run, attack, jump and hurt.
生成路径与 API key
| 顺序 | 路径 | 何时使用 |
|---|---|---|
| 1 | API：已配置的 key（OpenAI、Gemini、xAI、BytePlus、fal.ai：Kling v3、Veo 3.1、Luma、MiniMax、Wan、Vidu、LTX） | 配置了 key 即视为同意，不再逐次询问 |
| 2 | 本机 CLI：你已登录的 Codex（image_gen）或 Grok（图片、ACP 模式视频） |
没有 key 或 API 因账号原因拒绝时；使用订阅额度 |
| 3 | 代码绘制（codeart2d） | 最后手段：没有任何路径或你明确要求时 |
Key 放在环境变量（OPENAI_API_KEY、GEMINI_API_KEY、XAI_API_KEY、ARK_API_KEY、FAL_KEY）或用户配置文件（Windows：%APPDATA%\agent-sprite-forge\config.json；macOS／Linux：~/.config/agent-sprite-forge/config.json）。详见 Routes and providers。
链接
授权
MIT，见 LICENSE。