Character Animation for Agents

Character Animation for Agents

给静态 3D 模型绑定骨骼，并根据一句提示让它动起来，返回带骨骼的动画 GLB。面向智能体和开发者，可通过 REST、MCP 或浏览器使用，运行在 Hugging Face ZeroGPU 上。

由 townbox 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这是一个 Gradio Space，能根据一句话给 3D 模型绑定骨骼并生成动画。你发送一个静态模型文件（glb、gltf、obj 或 fbx）和一句简短提示，就会收到带骨骼的动画 GLB。它串联了两个已发布的研究模型，SkinTokens 负责骨骼和蒙皮权重，UniMate 负责根据文字生成动作。智能体可以通过 REST 或 MCP 调用它。

适合谁：开发需要动画 3D 角色的智能体或工具的开发者，想快速得到动作草稿的美术师，以及想把两个模型放在一起试用的研究者。

Industry | Who uses it | How they use it | Example
游戏 | 独立开发者 | 给静态角色得到一段动作草稿 | 要求一个物体向前走
软件 | 智能体开发者 | 通过 MCP 或 REST 从智能体调用这个服务 | 让智能体根据一句话任务给网格做动画
3D 美术 | 美术师 | 在手工做动画之前先试动作想法 | 对准备好的资产要求一个跳跃
研究 | 图形学研究者 | 在一个流程里试用 SkinTokens 和 UniMate | 对同一条提示比较多个样本

如果你的项目是商用的，可以跳过它，因为它的许可是 cc-by-nc-4，属于非商用许可。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 的页面里
• Claude Code 等 MCP 客户端，通过这个 Space 的 MCP 端点
• 任何能发送 REST 调用的程序，这个 Space 用 OpenAPI 做了说明
• Gradio 的 Python 和 JavaScript 客户端

Use case | Who | What they get back
给静态模型做动画 | 开发者和美术师 | 一个带骨骼的动画 GLB，含 60 帧动作，2 秒，30 帧每秒
只做骨骼绑定 | 流程搭建者 | 为网格预测出的骨骼和蒙皮权重
优化一段动作 | 动画师 | 补间、关节编辑或多提示扩展

如何设置：

• 在线页面什么都不用装
• 一个 Hugging Face 账号和令牌，用来从智能体调用服务
• 只有本地副本才需要 Python 3.12.12 和 pip
• 本地副本需要 requirements.txt 里列出的 Python 包

1. 想在线试用，就打开 Hugging Face 上这个 Space 的页面。
2. 想从智能体使用，先创建一个 Hugging Face 令牌，GPU 时间会通过它记到调用者自己的账号上。
3. 在你的客户端里把这个 Space 加成 MCP 服务器，或者调用它的 REST 端点。落地页提供可复制的客户端配置和一条 Claude Code 单行命令。
4. 想要本地副本，先安装 Hugging Face hub 包，再下载这个 Space。
5. 进入新文件夹，安装指定版本的 Gradio 和那些包，然后启动应用。

pip install -U huggingface_hub
hf download townbox/character-animation-for-agents --repo-type space --local-dir character-animation-for-agents
cd character-animation-for-agents
pip install gradio==6.17.3
pip install -r requirements.txt
python app.py

这个仓库不小，有 302 个文件，GPU 步骤本来就是要在托管的 Space 上运行的。

如何使用：在浏览器里，使用落地页。对智能体来说，页面上有一张卡片给出可以交出去的一句话提示，另一张卡片给出 MCP 连接信息。一次调用就能做完全部，大约要 40 到 90 秒。每个阶段也有自己的调用，资产可以按 id 重复使用。

python app.py

Tool | What it does
animate_mesh | 一次调用完成骨骼绑定和动画
rig | 预测骨骼和蒙皮权重
prepare_asset | 把骨骼变成可重复使用的资产
animate | 根据文字提示为资产生成动作
inbetween | 在姿势之间补出动作
edit_joints | 编辑一段动作的关节
expand | 根据多条提示扩展一段动作
view_rig、view_animation、view_asset | 骨骼、动作和资产的预览
service_info 和 guide | 服务信息和智能体指南

示例：你告诉智能体，用一条要求物体向前走的提示给一个机器人模型做动画。智能体发送文件，服务绑定骨骼、准备资产并生成 60 帧动作。大约一分钟后，一个动画 GLB 就返回了。

新手与专家：如果你是新手，先打开这个 Space 页面，看看落地页上的卡片。其中一张给出可以粘贴给 AI 智能体的短提示，内置示例让你不用自己的模型也能试。先选一个示例和一句简短提示。

如果你熟悉这个领域，骨骼由 TokenRig 预测，然后 Space 里的预处理步骤负责 Blender 导入、关节标签、一对朝向和标准 T 姿势。接着 UniMate 生成动作。只有 TokenRig 的前向过程和流的展开用到 GPU，智能体还可以在准备好的资产上修正标签、朝向和静止旋转。

发送 3D 模型和一句话
TokenRig 预测骨骼和蒙皮权重
骨骼变成可重复使用的资产
UniMate 生成 60 帧动作
你得到带骨骼的动画 GLB

注意事项：

• License: cc-by-nc-4
• Cost to run: 没有提到付款，但会用到 Hugging Face 令牌，GPU 时间由调用者的 ZeroGPU 额度承担
• Data it reaches: 你发送的 3D 文件，最大 60 MB，以及 Space 保留 24 小时的结果
• Not for: 这个非商用许可下的商业工作，或超过 60 MB 的文件

Hugging Face 上的数据（2026年11月13日）

• 点赞：1
• 构建方式：gradio
• 许可证：cc-by-nc-4.0

链接

• Space：https://huggingface.co/spaces/townbox/character-animation-for-agents
• 文件：https://huggingface.co/spaces/townbox/character-animation-for-agents/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。