sprite-animator 是一个把任意图像转成动画像素风精灵 GIF 的命令行工具，使用 Gemini 图像生成能力先产出 16 帧精灵表，再合成为循环 GIF。
用途：用户需要制作像素风动画、精灵表或动态 GIF 时使用，适用于照片、手绘或已有像素画等输入。
主要能力与用法：需设置 GEMINI_API_KEY 或 GOOGLE_API_KEY 环境变量。可通过 uv tool install sprite-animator 安装，或用 uvx sprite-animator 一次性运行。基本调用示例：sprite-animator -i photo.png -o dance.gif -a dance --two-step -s 256 -r 2K；对绘图或像素画可省略 --two-step。动画类型包括 idle（默认，轻微呼吸和眨眼）、wave（抬手挥手再收回）、bounce（下蹲跳跃落地）、dance（倾斜旋转跳跃）。主要选项：-i 输入图、-o 输出 GIF、-a 动画类型、-s 输出精灵尺寸（默认 128）、-r 生成分辨率（1K/2K）、-d 帧时长（默认 100ms）、--two-step（先像素化再动画，适合照片）、--keep-sheet（保存原始精灵表）、--keep-frames（保存逐帧 PNG）。
官方提示：处理真人照片建议用 --two-step，否则 Gemini 易丢失人物相似度；-r 2K 可提升质量；-d 180 播放更自然。也提供 Python API，可导入 ANIMATION_PRESETS、generate_sprite_sheet、create_gif、call_gemini、get_api_key、create_template、extract_frames 等函数进行定制。
限制：依赖 Gemini API 密钥；具体收费、可用平台与效果等资料暂未提供。