Click3R

Click3R

从一对照片重建 3D 场景，你可以用几次点击标出两张图里的同一个点来修正结果。这是面向计算机视觉研究者和学生的研究演示。

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

简介

它是什么：Click3R 是一个研究演示，用两张照片重建 3D 场景。你在两张图里点出同一个点，这些成对的点击会把模型引向更好的结果。它和预训练的 DUSt3R 模型放在一起，方便你对比两者。

适合谁：适合做 3D 视觉的人，也适合想看几次点击如何修正出错重建的学生。

Industry | Who uses it | How they use it | Example
科研 | 计算机视觉研究者 | 对比有无点击时的重建效果 | 打开 Cellphone 这一对图，加上它的一次点击
教育 | 学生 | 看相机位姿误差在 3D 里的表现 | 试试取自论文的 Bicycle 图对
3D 爱好 | 好奇的创作者 | 测试两张照片如何变成 3D 视图 | 加载 Toy truck 示例

需要成品扫描应用，或需要一次处理很多照片的工具的人可以跳过它，因为这个演示只处理图对。

用在哪里：

• 浏览器：这个 Space 在 Hugging Face 上运行，不用安装任何东西
• Windows、macOS 或 Linux：用 Python 3.12 运行 Space 的本地副本

Use case | Who | What they get back
测试稀疏点击 | 研究者 | 随点击增加而变化的 3D 结果
研究失败案例 | 学生 | DUSt3R 与 Click3R 的并排对比
试用现成图对 | 好奇的人 | 23 个带点击的示例图对之一

如何设置：

• Windows、macOS 或 Linux 上的 Python 3.12 和 pip
• requirements.txt 里列出的 Python 包
• 首次启动时需要网络，Space 会在那时获取检查点

1. 安装 Hugging Face hub 包。
2. 把 Space 的文件下载到一个文件夹。
3. 进入这个文件夹。
4. 安装 Gradio 6.31.0 和 requirements.txt 里的包。
5. 启动应用。

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

如何使用：在浏览器里打开 Space 页面，或者用下面的命令启动你自己的副本。从 23 个带点击的示例图对里选一个，再对比 3D 结果。

python app.py

示例：你选 Cellphone 这一对，它只用一对点击。README 列出的位姿误差是：加点击后 3.1 度，同一对图上 DUSt3R 为 165.0 度。

新手与专家：如果你是新手，先在浏览器里打开这个 Space，试试 Cellphone 示例。它只需要一对点击，是最容易跟着看懂的情况。

如果你是专家，这个演示把 Click3R 检查点和 DUSt3R ViTLarge 对比权重放在一起。示例来自论文图、Hard3DBench 图对上的人工点击，以及通过搜索挑出的图对，在这些图对上 DUSt3R 和没有点击的 Click3R 都出了错。

你打开一对图像
你在两个视图里标出对应点
Click3R 用点击修正位姿
你看到 3D 结果

Title: Cellphone 示例的位姿误差，单位为度
DUSt3R: 165.0 度
Click3R 无点击: 133.5 度
Click3R 有点击: 3.1 度

注意事项：

• License: cc-by-nc-sa-4，按 Space 的标注
• Cost to run: 没有提到
• Data it reaches: 首次启动时从 Hugging Face 下载的检查点，以及示例图片
• Not for: 把示例图片用于商业用途，因为它们适用各自数据集的许可

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

• 点赞：1
• 构建方式：gradio
• 许可证：cc-by-nc-sa-4.0

链接

• Space：https://huggingface.co/spaces/uva-cv-lab/Click3R
• 文件：https://huggingface.co/spaces/uva-cv-lab/Click3R/tree/main

试用

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