Improve model card
#1
by nielsr HF Staff - opened
README.md
CHANGED
|
@@ -1,3 +1,56 @@
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
|
|
|
| 3 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
| 3 |
+
pipeline_tag: image-to-3d
|
| 4 |
---
|
| 5 |
+
|
| 6 |
+
# R³: 3D Reconstruction via Relative Regression
|
| 7 |
+
|
| 8 |
+
R³ is a feed-forward geometry foundation model that reconstructs camera poses and dense geometry from arbitrarily long video streams via relative-pose regression. Instead of regressing every camera in one global frame, R³ predicts confidence-weighted pairwise relative poses on top of a Depth Anything 3 backbone, then assembles a consistent global trajectory downstream.
|
| 9 |
+
|
| 10 |
+
[**Project Page**](https://kevinxu02.github.io/r3-site/) | [**Paper**](https://huggingface.co/papers/2605.26519) | [**GitHub**](https://github.com/KevinXu02/R3)
|
| 11 |
+
|
| 12 |
+
## Quick Start
|
| 13 |
+
|
| 14 |
+
### Installation
|
| 15 |
+
|
| 16 |
+
```bash
|
| 17 |
+
conda env create -f environment.yml
|
| 18 |
+
conda activate r3
|
| 19 |
+
pip install -e .
|
| 20 |
+
```
|
| 21 |
+
|
| 22 |
+
Alternatively, if you already have a CUDA-enabled PyTorch environment:
|
| 23 |
+
|
| 24 |
+
```bash
|
| 25 |
+
pip install -r requirements.txt
|
| 26 |
+
pip install -e .
|
| 27 |
+
```
|
| 28 |
+
|
| 29 |
+
### Run the Demo
|
| 30 |
+
|
| 31 |
+
You can run inference on a sequence and visualize it using the following command:
|
| 32 |
+
|
| 33 |
+
```bash
|
| 34 |
+
python demo.py --seq_path examples/indoor --no_viewer
|
| 35 |
+
```
|
| 36 |
+
|
| 37 |
+
Presets for common scenarios:
|
| 38 |
+
|
| 39 |
+
```bash
|
| 40 |
+
python demo.py --mode local # indoor scenes, small coverage
|
| 41 |
+
python demo.py --mode long # long trajectories, large outdoor scenes
|
| 42 |
+
python demo.py --mode strided # temporally strided video
|
| 43 |
+
```
|
| 44 |
+
|
| 45 |
+
## Citation
|
| 46 |
+
|
| 47 |
+
If R³ is useful in your research or projects, please cite:
|
| 48 |
+
|
| 49 |
+
```bibtex
|
| 50 |
+
@article{r3_2026,
|
| 51 |
+
title = {R^3: 3D Reconstruction via Relative Regression},
|
| 52 |
+
author = {Anonymous},
|
| 53 |
+
year = {2026},
|
| 54 |
+
note = {Paper coming soon}
|
| 55 |
+
}
|
| 56 |
+
```
|