Hi3DGen

Hi3DGen

用 Stable-X 的 trellis-normal 模型，从一张图片生成细节丰富的 3D 几何体。这是一个面向 3D 美术师、游戏开发者和研究者的 Gradio 应用，在 Hugging Face 上通过浏览器运行。

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

简介

它是什么：这是一个 Gradio 应用，能用一张图片建出 3D 形状。页面把输出描述为高保真几何体，并点名了 Stable-X 的 trellis-normal-v0-1 模型。它在 Hugging Face 的 zero-a10g 硬件上运行，所以你在浏览器里就能试用，不用安装任何东西。

适合谁：想从参考图得到一个起始形状的 3D 美术师和游戏开发者，以及关注单图 3D 研究的研究者。

Industry | Who uses it | How they use it | Example
游戏 | 游戏美术师 | 从参考图得到一个基础形状 | 把一张道具概念图变成待细化的网格
3D 美术 | 建模师 | 在手工雕刻之前先试单图几何体 | 把结果和自己的模型对比
研究 | 图形学研究者 | 在自己的图片上试用 Stable-X 模型 | 跑几张图片并检查形状
软件 | 开发者 | 阅读 app.py，看流程是怎么接入 Gradio 的 | 把这套布局用到另一个模型上

如果你需要完整的多视角扫描，可以跳过它，因为这个应用只用一张图片。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 的页面里
• 装有 Python 的 Windows、macOS 或 Linux，作为本地副本

Use case | Who | What they get back
根据图片生成 3D 几何体 | 美术师和开发者 | 由图片建出的 3D 形状
在本地试用模型 | 研究者 | 一个正在运行的应用副本

如何设置：

• 如果只用在线 Space，就什么都不用装
• 本地副本需要 Python 和 pip
• requirements.txt 里列出的 Python 包

1. 想在线使用，就打开 Hugging Face 上这个 Space 的页面。
2. 想要本地副本，先安装 Hugging Face hub 包，再下载这个 Space。
3. 进入新文件夹，安装指定版本的 Gradio。
4. 安装 requirements.txt 里的包。
5. 用 Python 启动应用。

pip install -U huggingface_hub
hf download Stable-X/Hi3DGen --repo-type space --local-dir Hi3DGen
cd Hi3DGen
pip install gradio==5.34.2
pip install -r requirements.txt
python app.py

这个仓库不小，有 251 个文件，其中有名为 trellis、extensions 和 wheels 的文件夹。页面没有说明本地运行除了这些包还需要什么。

如何使用：在线使用时，打开这个 Space，通过页面上的表单放入一张图片。在自己的电脑上，运行应用文件，然后在浏览器里打开 Gradio 提供的页面。页面没有列出其他命令。

Tool | What it does
python app.py | 在你的电脑上启动 Gradio 应用

示例：你打开这个 Space，上传一张单个物体的清晰图片，比如一把椅子。应用用这一个视角建出 3D 形状，你仔细看看，判断它是不是适合作为你自己工作的基础。

新手与专家：如果你是新手，先在线打开这个 Space，试一张背景简单、物体单一的清晰图片。单视角 3D 是对看不见那几面的猜测，所以请从多个角度检查结果。

如果你熟悉这个领域，这个应用封装的是 Stable-X 的 trellis-normal-v0-1 模型。页面有一个 Paper 标题，下面却是空的，所以在依赖法线处理或输出格式等细节之前，请先到别处找方法说明。

在浏览器里打开 Space
放入一张图片
trellis-normal 模型构建几何体
你检查 3D 结果

注意事项：

• License: mit
• Cost to run: 没有提到费用，不过这个 Space 在 Hugging Face 的 zero-a10g 硬件上运行
• Data it reaches: 你上传的图片，以及它从 Hugging Face 拉取的模型文件

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

• 点赞：716
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/Stable-X/Hi3DGen
• 文件：https://huggingface.co/spaces/Stable-X/Hi3DGen/tree/main

试用

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