RealDenseFace

RealDenseFace

用 RealDenseFace ViT-B 模型，从一张人像照片重建 3D 人脸。它显示人脸几何的可视化结果，在浏览器里于 ZeroGPU 上运行。

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

简介

它是什么：RealDenseFace 能从一张人像照片重建人脸的 3D 形状。你上传一张人像或挑一个示例，RealDenseFace ViT-B 模型就会重建出人脸几何。输出只是可视化结果。这个 Space 运行在 Hugging Face 上，所以你在浏览器里就能试用，不用安装任何东西。

适合谁：研究单张图像人脸重建的计算机视觉研究人员，以及想看看人脸几何是怎么从照片里恢复出来的开发者和 3D 美术师，都适合用它。

Industry | Who uses it | How they use it | Example
研究 | 人脸重建研究人员 | 在人像上测试 ViT-B 模型 | 上传一张人像，查看几何结果
动画 | 3D 美术师 | 看看人脸的形状是怎么从照片里恢复出来的 | 试其中一个示例
软件 | 开发者 | 研究一个带原生求解器的 ZeroGPU 应用 | 阅读 app.py 和 engine.py
教育 | 学生 | 了解一张照片怎么能得到 3D 人脸 | 把输入照片和可视化结果对照

想要可下载的 3D 模型或模型权重的人可以跳过，因为输出只是可视化结果。

用在哪里：它可以在这些地方运行。

• 网页浏览器，打开 Hugging Face 上的 Space 页面
• Windows，需要 Python 3.12
• macOS，需要 Python 3.12
• Linux，需要 Python 3.12

Use case | Who | What they get back
重建一张人脸 | 研究人员 | 人脸几何的可视化结果
试一个示例 | 新手 | 不用自己的照片就能得到的快速结果
研究这个流程 | 开发者 | 一份带 tracker 和 models 文件夹的本地副本可供阅读

如何设置：在线使用这个 Space 只需要浏览器。在你自己的电脑上运行一份副本，需要下面这些。

• Python 3.12 和 pip
• huggingface_hub 包，它提供 hf 命令
• packages.txt 里列出的系统软件包，线上的 Space 用 apt-get 安装它们
• 你自己获得授权的标准 FLAME 模型，以及它的读取令牌，因为仓库里不包含这个模型
• 足够的磁盘空间，仓库里有 730 个文件

1. 安装 huggingface_hub 包。
2. 把这个 Space 的文件下载到本地文件夹。
3. 进入这个文件夹。
4. 安装这个 Space 使用的 Gradio 版本，再安装 requirements.txt 里的包。
5. 启动应用。

pip install -U huggingface_hub
hf download LinzhouLi/RealDenseFace --repo-type space --local-dir RealDenseFace
cd RealDenseFace
pip install gradio==6.31.0
pip install -r requirements.txt
python app.py

如何使用：打开 Space 页面，或者在你的电脑上运行应用，再打开 Gradio 显示的页面。上传一张人像或挑一个示例，然后查看它显示的重建结果。

python app.py

Tool | What it does
app.py | 主文件，负责搭建 Gradio 页面
engine.py | 存放重建引擎的代码
examples 文件夹 | 存放可以试用的示例人像
FLAME_READ_TOKEN | 一个 Space 密钥，授予对私有 FLAME 资源仓库的读取权限

示例：你上传一张正面、脸部清晰的人像。这个 Space 会返回重建出的人脸几何的可视化结果，不提供任何模型文件或参数下载。

新手与专家：单目的意思是只有一个摄像头，所以模型只根据一张照片工作。第一件可以试的小事，是试一个内置的示例。

这个模型借助稠密的 UV 先验，而标准的 FLAME 人脸模型是单独授权的运行时依赖，仓库里并不附带。原生 FLAME 求解器的编译在启动时于 CPU 上进行，网络只加载一次并放到 CUDA 上。请求一次处理一个，输入的最长边限制为 1280 像素。

你上传一张人像或挑一个示例
图像被限制在 1280 像素以内
RealDenseFace ViT-B 重建几何
应用显示可视化结果

注意事项：复制出来的 Space 需要有自己获得授权的 FLAME 模型和读取令牌。

• License: mit，而 FLAME 模型有它自己单独的许可证
• Cost to run: 一个获得授权的 FLAME 模型，以及它的读取令牌，名为 FLAME_READ_TOKEN
• Data it reaches: 你上传的人像，它不会被刻意保留到 Gradio 的临时缓存之外，这个缓存一小时后过期
• Not for: 下载模型参数或文件，应用不提供这些
• Hardware: 这个 Space 设为在 Hugging Face 的 zero-a10g 上运行

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

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

链接

• Space：https://huggingface.co/spaces/LinzhouLi/RealDenseFace
• 文件：https://huggingface.co/spaces/LinzhouLi/RealDenseFace/tree/main

试用

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