img2threejs

看图片，自动生成可动画的 Three.js 模型代码

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 1735 🐛 待处理 120 👀 关注 69

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 20597

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0许可证，可免费使用和部署。

项目预览

项目数据

分类智能体

开发团队img2threejs

官网地址https://img2threejs.io

GitHubhttps://github.com/img2threejs/img2threejs

定价模式🏷️完全免费

价格说明开源项目，Apache-2.0许可证，可免费使用和部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型3d,ai-agents,claude-code,computer-graphics,generative,image-to-3d,procedural-generation,threejs,typescript,webgl

GitHub 星标★ 20597

上线时间2026-07-15 00:00:00

代码更新2026-11-05

仓库体积35.5 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数7

项目介绍

img2threejs 是一个将参考图片中的物体重建为纯代码、程序化、质量门控、可动画的 Three.js 模型的开源项目。它利用 AI 智能体（如 Claude Code）理解图像，并生成高效的 Three.js 代码，从而实现图像到 3D 的转换。该项目解决了传统图像转 3D 模型方法中常见的文件体积大、难以编辑和动画化的问题，通过程序化生成和代码化表示，让生成的 3D 模型轻量、可定制且易于集成到 Web 应用中。其核心能力包括：基于视觉理解的自动建模、代码级质量控制、以及生成模型的动画就绪性。项目主要面向开发者，特别是那些需要在网页中快速生成可交互 3D 内容的场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 20597

技术标签

3d ai-agents claude-code computer-graphics generative

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Claude Code 或其他兼容的智能体宿主（技能需放入其 skills 目录）
git（用于克隆仓库）
Node.js / npx（仅在安装 img2 harness 与领域插件时需要）
Python 3（仅在多会话重建、初始化状态索引时需要）

安装与启动步骤

1克隆到技能目录

把仓库直接克隆进宿主 skills 目录，路径按 README 给出的 ~/.claude/skills/img2threejs 放置。
```
git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs
```
2多宿主软链接

同时使用多个宿主时，只保留一份 checkout，让每个入口以软链接指向它，避免版本漂移。
3安装 img2 工具

可选。领域知识不在本仓库中，需先安装 img2 harness，它会创建 ~/.img2、插件注册表和 img2 启动器。
```
npx github:img2threejs/img2 install
```
4添加领域插件

可选。按需安装插件，如 CS2 皮肤重建。未装插件时仅 generic 与 character 两个 profile 可用。
```
img2 add img2threejs/plugin-cs2
```
5审计插件

可选。对每个已安装插件做 fail-loud 静态审计，检查安装是否完整可用。
```
img2 doctor
```
6调用重建技能

在 Claude Code 中附上或指向物体图片，然后执行该斜杠命令即可启动逐轮重建与质量门控。
```
/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.
```

7多会话初始化状态

跨多次会话重建时，先用脚本初始化本地状态索引，再取下一步任务继续推进。

python3 forge/state.py init --reference <image> --profile character --spec object-sculpt-spec.json
python3 forge/next.py --state .img2threejs/state.json

关键配置

配置项	必填	说明	示例
`profile`	是	选择重建档案，决定检查清单与质量门槛。	`character`
`--reference`	是	指定作为重建依据的参考图片路径。	`<image>`
`--spec`	否	指定重建规格文件，约束生成目标。	`object-sculpt-spec.json`
`--state`	是	本地状态索引文件路径，供下一步脚本读取。	`.img2threejs/state.json`