nielsr HF Staff commited on
Commit
bc0340e
·
verified ·
1 Parent(s): 9caf97c

Add model details, paper links and usage information

Browse files

Hi, I'm Niels, part of the community science team at Hugging Face.

I noticed this model card was missing some information. This PR:
- Adds a description of Boxer and BoxerNet.
- Links the model card to the corresponding paper, project page, and GitHub repository.
- Adds the `object-detection` pipeline tag for better discoverability.
- Adds a sample usage section using the CLI commands found in the README.
- Adds a citation section.

Files changed (1) hide show
  1. README.md +45 -2
README.md CHANGED
@@ -1,10 +1,53 @@
1
  ---
 
 
2
  license: cc-by-nc-4.0
 
3
  tags:
4
  - 3d-object-detection
5
  - open-world-detection
6
  - 3d-vision
7
- datasets:
8
- - facebook/boxer
9
  ---
10
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ datasets:
3
+ - facebook/boxer
4
  license: cc-by-nc-4.0
5
+ pipeline_tag: object-detection
6
  tags:
7
  - 3d-object-detection
8
  - open-world-detection
9
  - 3d-vision
 
 
10
  ---
11
 
12
+ # Boxer: Robust Lifting of Open-World 2D Bounding Boxes to 3D
13
+
14
+ [Project Page](https://facebookresearch.github.io/boxer) | [Paper](https://huggingface.co/papers/2604.05212) | [Code](https://github.com/facebookresearch/boxer)
15
+
16
+ Boxer is an algorithm designed to estimate static 3D bounding boxes (3DBBs) from 2D open-vocabulary object detections, posed images, and optional depth data. At its core is **BoxerNet**, a transformer-based network which lifts 2D bounding box (2DBB) proposals into 3D, followed by multi-view fusion and geometric filtering to produce globally consistent de-duplicated 3DBBs in metric world space.
17
+
18
+ ![Boxer System Architecture](https://github.com/facebookresearch/boxer/raw/main/docs/images/boxer_system.jpg)
19
+
20
+ ## Installation
21
+
22
+ We recommend using [uv](https://docs.astral.sh/uv/) to manage the environment:
23
+
24
+ ```bash
25
+ # Create virtual environment
26
+ uv venv boxer --python 3.12
27
+ source boxer/bin/activate
28
+
29
+ # Core dependencies for running Boxer
30
+ uv pip install 'torch>=2.0' numpy opencv-python tqdm dill
31
+ ```
32
+
33
+ ## Usage
34
+
35
+ After installation and downloading the required checkpoints using the scripts provided in the repository, you can run BoxerNet on sample data. For example, to run BoxerNet in headless mode on a sample sequence:
36
+
37
+ ```bash
38
+ python run_boxer.py --input nym10_gen1 --max_n=90 --track
39
+ ```
40
+
41
+ This will estimate 3D bounding boxes and save the results (CSV and visualization) to the `output/` directory.
42
+
43
+ ## Citation
44
+
45
+ If you find Boxer useful in your research, please consider citing:
46
+
47
+ ```bibtex
48
+ @article{boxer2026,
49
+ title={Boxer: Robust Lifting of Open-World 2D Bounding Boxes to 3D},
50
+ author={Daniel DeTone and Tianwei Shen and Fan Zhang and Lingni Ma and Julian Straub and Richard Newcombe and Jakob Engel},
51
+ year={2026},
52
+ }
53
+ ```