Marigold V2 klein Normal to Height

Marigold V2 klein Normal to Height

用 FLUX.2 klein 4B 上的 Marigold V2，一步就把切线空间法线贴图变成高度图。这是一个面向纹理和 3D 材质工作的 Gradio 应用。

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

简介

它是什么：这是一个 Gradio 应用，用切线空间法线贴图生成高度图。它在 FLUX.2 klein 4B 之上使用 Marigold V2，并在 Megascans 和 MatSynth 上做了微调，转换只需一个 transformer 步骤。它在 Hugging Face 的 zero-a10g 硬件上运行。

适合谁：手里有法线贴图、需要配套高度图的纹理和 3D 材质美术师，以及想看看这个模型如何被封装成应用的开发者。

Industry | Who uses it | How they use it | Example
游戏 | 场景美术师 | 为一种材质得到配套的高度图 | 转换一面石墙的法线贴图
软件 | 开发者 | 阅读 app.py 和 tiling.py，看图像是怎么处理的 | 复用 Gradio 布局
研究 | 图形学研究者 | 试用法线转高度的模型 | 跑几张贴图并查看结果

如果你是从照片或颜色贴图出发，可以跳过它，因为输入是法线贴图。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 的页面里
• 你自己电脑上的本地副本，前提是装好了 Python 3.12

Use case | Who | What they get back
生成高度图 | 纹理美术师 | 由你的法线贴图得到的高度图
试用模型 | 研究者 | 一种测试法线转高度微调模型的方式

如何设置：

• 使用在线 Space 什么都不用装
• 本地副本需要 Python 3.12 和 pip
• requirements.txt 里列出的 Python 包
• 一个能读取私有模型仓库的令牌，设为 HF_TOKEN 密钥

1. 想在线使用，就打开 Hugging Face 上这个 Space 的页面。
2. 想要本地副本，先安装 Hugging Face hub 包，再下载这个 Space。
3. 进入新文件夹，安装指定版本的 Gradio。
4. 安装 requirements.txt 里的包。
5. 确认 HF_TOKEN 里放着能访问该模型仓库的读取令牌，然后启动应用。

pip install -U huggingface_hub
hf download NightRaven109/marigold-v2-klein-normal-to-height --repo-type space --local-dir marigold-v2-klein-normal-to-height
cd marigold-v2-klein-normal-to-height
pip install gradio==6.24.0
pip install -r requirements.txt
python app.py

这个 Space 从一个私有模型仓库读取权重。一个叫 MODEL_REPO 的设置可以指向另一个仓库 id。

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

Tool | What it does
python app.py | 在你的电脑上启动 Gradio 应用
HF_TOKEN | 存放模型仓库读取令牌的密钥
MODEL_REPO | 覆盖权重所在的仓库 id

示例：你上传一面砖墙的法线贴图并运行转换。应用一步就返回这面墙的高度图，你可以把它存下来，和其他纹理文件放在一起用。

新手与专家：如果你是新手，法线贴图存的是表面朝向，而高度图存的是每个点有多高。先在线打开这个 Space，试一张小的法线贴图。

如果你熟悉这个领域，这个模型是 FLUX.2 klein 4B 上的 Marigold V2，在 Megascans 和 MatSynth 上微调，用一个 transformer 步骤预测高度。app.py 旁边还有一个 tiling.py 文件，但页面没有解释它。

上传切线空间法线贴图
FLUX.2 klein 4B 上的 Marigold V2 运行一次
预测出一张高度图
你下载这张高度图

注意事项：

• License: apache-2
• Cost to run: 没有提到费用，不过私有权重需要一个 Hugging Face 读取令牌
• Data it reaches: 你上传的法线贴图，以及从私有仓库读取的模型权重
• Not for: 从照片或颜色贴图出发，因为输入是切线空间法线贴图

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

• 点赞：1
• 构建方式：gradio
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/NightRaven109/marigold-v2-klein-normal-to-height
• 文件：https://huggingface.co/spaces/NightRaven109/marigold-v2-klein-normal-to-height/tree/main

试用

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