img2threejs / img2threejs 开源许可前往官方获取

img2threejs:把参考图重建为可编辑 Three.js 代码

供 AI 编程助手使用的图像转 Three.js 工作流,通过分析、代码建模与浏览器视觉验收,重建可编辑的程序化三维场景。

项目说明 README交流使用心得 ↗
img2threejs:把参考图重建为可编辑 Three.js 代码

它能做什么

供编码智能体使用的图像转 Three.js 程序化重建技能。通过参考图分析、规格定义、分阶段代码建模、浏览器渲染与视觉验收生成可编辑代码场景;主要路线不是摄影测量、扫描或下载现成网格。适合希望在网页里直接控制模型结构、动画与交互的前端开发者,以及已有编码智能体的创作者。它按 blockout、结构、形体、材质、表面、灯光、交互和优化逐步推进,并用浏览器截图对照参考图进行门禁和返工。这样输出的核心价值是可编辑代码:可以修改几何参数和动画逻辑,而不是只有一个不可解释的结果文件。它也意味着重建依赖代理多轮理解与生成,复杂角色或背面信息不足时需要补参考、调规则,并关注模型调用的成本。

输入、输出与使用流程

输入:参考图片、建模约束;宿主需有视觉及编程能力。输出:Three.js/TypeScript 程序化几何、材质、灯光、交互代码,默认不是 GLB 安装包。请按官方示例先完成最小流程,再依据自己的资产要求调整参数;下游软件的格式兼容性与交付质量需要分别检查。

安装与运行门槛

CLI 需 Node≥18、Git;脚本 Python≥3.10;支持 Hermes、Claude Code、Codex、OpenCode。基础技能和可选 img2 插件 harness 是两个独立包。 硬件说明:默认浏览器 Three.js 渲染,无仓库强制24GB显卡条件;速度/成本主要受所用智能体和模型推理限制。

使用边界与许可

单张图不可见面仍需假设或增加参考。 默认不输出下载网格;img2glb 为另选插件,走托管 TRELLIS。 environment 插件私有,需授权Git访问;不是全插件免费开放。 质量门禁不等于生产可用承诺,生成代码和素材权利仍需检查。 授权核对:Apache-2.0(实际 LICENSE 已读取,用户标注核实正确)。开源技能免费不代表智能体推理免费。依赖用户配置的 AI 宿主/模型,可能消耗订阅或 API token;Atlas Cloud/Tripo/Hyper3D 是赞助/可选路径,不应写必需全部购买。

官方资料

RELEASES

版本与下载

代码、发行版本与运行方法由官方项目维护。请按官方文档选择安装路径;在线服务、模型和第三方 API 可能有独立的许可与费用。

上游文件由第三方提供,未经过本站文件安全审查。

CONTRIBUTE

一起让项目更好

发现问题、写下使用心得,或分享你做的改进。小到一个修复、一份中文教程,都可以帮助下一位使用者。

01

反馈与讨论

写出使用环境、复现步骤或优化建议,让问题更容易被理解。

参与讨论 ↗
02

分享改进版本

附上改动源码、适用版本与使用说明,让大家了解你做了什么。

03

贡献给上游

从 Fork 开始,通过 Pull Request 把改进提交给原项目。

在 GitHub Fork ↗

网友改进版本

以改动源码、分支或 PR 的形式分享,审核通过后展示;请查看原许可证与改动说明后使用。

还没有网友分享改进版本。你可以成为第一位贡献者。

COMMUNITY

评分与讨论

0 条讨论
—

还没有评分,期待你的真实使用感受

从你的第一条分享开始

可以聊聊实际效果、安装经验,或者你想解决的一个小问题。

相关内容
Google model-viewer:让网页直接展示可旋转的 3D 模型与 AR 预览
GitHub
  • 开发组件
InspireFace:跨平台人脸检测与识别开发 SDK
GitHub
  • 开发组件