Improve model card

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +53 -0
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
+ ```