image-to-3dlab

本地把图片文字变成带骨骼的游戏 3D 模型

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 数字人3D 🍴 复刻 135 🐛 待处理 17 👀 关注 7
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1231
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,本地运行

项目预览

image-to-3dlab 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类数字人3D
开发团队Bingeljell
定价模式🏷️完全免费
价格说明开源免费,本地运行
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型3d-generation,3d-models,animation,apple-silicon,auto-rigging,blender,game-assets,gamedev,generative-ai,godot,hunyuan3d,image-to-3d,indie-game-dev,local-first,mlx,pixal3d,rigging,text-to-3d,trellis,unity
GitHub 星标★ 1231
上线时间2026-08-02 00:00:00
代码更新2026-11-20
仓库体积15.1 MB
本站数据更新2026-11-21
维护状态活跃
收录时间2026-10-07
浏览次数3

项目介绍

image-to-3dlab 是一个在本地机器上把图片或文字转成游戏可用 3D 模型的工具集。它解决的是 AI 生成 3D 资产难以直接进游戏管线的问题:生成结果往往拓扑混乱、没有骨骼、缺少贴图,无法直接用于引擎。项目把多家开源 3D 生成模型(Pixal3D、TRELLIS.2、Hunyuan3D、SF3D)统一封装,提供重拓扑、重绘贴图、绑定骨骼和动画辅助等后处理能力,并同时给出网页查看器和命令行两种使用方式。支持 Apple Silicon 与 NVIDIA 显卡,本地运行无需上传数据。每个生成结果都会附带对应的许可证信息,方便判断能否商用。适合独立开发者、游戏美术和数字人内容创作者快速产出可用的 3D 资产。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 1231

使用教程

难度:入门 约 30 分钟 部署方式:本地安装 7 步

环境要求

  • macOS(Apple Silicon)或 Linux;Windows 版测试有限
  • 安装器会自动安装 Python 3.11
  • NVIDIA 显卡运行 Hunyuan3D-2.1 需 Linux 与 24 GB+ 显存
  • AMD 显卡需 Linux + ROCm,仅 Pixal3D 路线可用
  • 预留充足磁盘空间存放模型权重(约 8.4 GB ~ 19.5 GB)

安装与启动步骤

  1. 1先查看安装脚本

    安装器会改动系统环境,README 建议先下载脚本自行阅读,确认无误后再执行。

    curl -fsSL https://assetfurnace.com/install.sh -o install.sh
  2. 2Mac/Linux 一键安装

    脚本会检查机器、安装代码与 Python 3.11,随后启动工作室并在浏览器打开页面。

    curl -fsSL https://assetfurnace.com/install.sh | bash
  3. 3Windows 安装

    在 PowerShell 中执行;Windows 上不会自动打开浏览器,而是打印后续启动命令。

    irm https://assetfurnace.com/install.ps1 | iex
  4. 4下载模型权重

    安装器不下载权重。可在界面的 Setup & Status 里选(会显示体积与许可证),或用脚本装 Pixal3D。

    python scripts/bootstrap_pixal3d.py
  5. 5安装目录内再次启动

    工作室运行在终端窗口,Ctrl+C 停止;之后在安装目录用 lab 命令重新启动(Windows 用 .\lab)。

    ./lab
  6. 6脚本化无交互安装

    适合自动化场景,--yes 跳过确认并把安装目录指到 ~/lab;--dry-run 只预览不执行。

    curl -fsSL https://assetfurnace.com/install.sh | bash -s -- --yes --dir ~/lab
  7. 7复制运行清单模板

    需要可复现或可审计的运行记录时,复制示例 manifest 再修改其中的输入、后端与参数。

    cp manifests/example-trellis2.json manifests/my-run.json

关键配置

配置项必填说明示例
--dir否指定安装目录,供无交互安装使用~/lab
--yes否跳过交互确认,直接按参数安装--yes
--dry-run否只显示脚本将要执行的动作,不做实际改动--dry-run
I3D_NO_USAGE否设为 1 关闭匿名使用统计上报1
DO_NOT_TRACK否设为 1 同样可关闭使用统计1

如何确认成功

安装结束后终端显示工作室运行信息,浏览器自动打开操作界面;Windows 则按终端提示的命令手动启动。

常见问题

Q:安装器会自动下载模型权重吗?

A:不会。权重需在 Setup & Status 中自行选择,界面会写明每个模型的体积和许可证,并先询问确认。

Q:装完之后怎么再次启动?

A:在安装目录执行 ./lab(Windows 为 .\lab);要更新则先停止服务,重新执行安装命令再启动。

Q:Windows 能正常用吗?

A:README 说明 Windows 支持仍属有限测试,并邀请用户反馈结果;安装完成后需按终端打印的命令启动。

Q:AMD 显卡能用哪些后端?

A:Linux + ROCm 环境下仅 Pixal3D 可用,首次安装需本地编译约 10-20 分钟;TRELLIS.2 与 Hunyuan3D-2.1 不提供。

Q:如何关闭匿名使用统计?

A:在 About 页面取消勾选,或设置环境变量 I3D_NO_USAGE=1(或 DO_NOT_TRACK=1),即可停止并清除随机 id。

注意事项

  • 每个生成结果都附带对应许可证信息,商用前请先确认后端权重的授权条款。
  • TRELLIS.2 在 Mac 上把 Attention backend 设为 mlx 可明显提速;平面插画类参考图易出现色彩漂移。
  • 权重文件较大,注意预留磁盘空间与首次运行的下载等待时间。
  • 工作室运行在当前终端窗口,关闭窗口即中断任务。

核心亮点

  • 统一封装 Pixal3D、TRELLIS.2、Hunyuan3D、SF3D 多个生成后端,切换模型不用改工作流
  • 内置重拓扑、重绘、绑定和动画辅助,生成结果更接近可直接进引擎的游戏资产
  • 同时提供网页查看器和 CLI,本地跑在 Apple Silicon 与 NVIDIA 上,数据不出本机

不足之处

  • 项目仍处早期,569 星标意味着生态和文档成熟度有限
  • 依赖多个大模型权重,本地显存和磁盘占用门槛较高

适用场景

  • 独立游戏开发者用参考图快速生成道具、角色等游戏资产
  • 数字人创作者从单张照片生成带骨骼绑定的 3D 角色
  • 3D 美术用文字描述生成概念模型,再在 Blender 中精修

替代项目

TRELLIS、Hunyuan3D、Stable Fast 3D

上一篇:CorbeauSplat

下一篇:realvirtual-WEB

同类项目推荐

DreamScene 开源

输入一句话,自动生成多物体 3D 场景,布局合理不打架

[ECCV2024] DreamScene: 3D Gaussian-based Text-to-3D Scene Generation via Formation P···

★ 232 2026-08-09
echomimic 开源

上传音频和照片,一键生成逼真数字人说话视频,还能手动微调表情。

[AAAI 2025] EchoMimic: Lifelike Audio-Driven Portrait Animations through Editable La···

★ 4335 2026-08-09
DreamWaltz-G 开源

从单张图或文本,快速生成可动会笑的 3D 数字人

[TPAMI 2025] Official implementation of the paper "DreamWaltz-G: Expressive 3D Gauss···

★ 158 2026-08-09
OpenAmika 开源

会说话、有形象、记得你的开源虚拟伴侣

OpenAmika: MekaHime's AI companion Amika, open source. Live2D avatar, real-time voic···

★ 679 2026-11-09
BANDORI-PET-REV 开源

BanG Dream! 角色住进桌面,50+ 角色随切随陪

BandoriPet 是一个基于 Live2D 和 PySide6 的开源桌面宠物项目,支持 50+ 位 BanG Dream! ···

★ 526 2026-10-19
VideoScene 开源

输入图像,一步生成 3D 场景,告别多步优化

[CVPR 2025 Highlight] VideoScene: Distilling Video Diffusion Model to Generate 3D Sc···

★ 356 2026-08-09
DiffusionGAN3D 开源

融合3D GAN与扩散先验,让文本快速生成高质量3D模型

[CVPR2024] DiffusionGAN3D: Boosting Text-guided 3D Generation and Domain Adaptation ···

★ 70 2026-08-09
ChatVRM 开源

浏览器里让 VRM 虚拟人开口和你聊天

Chat with VRM avatar via LLM

★ 151 2026-10-28