---
title: README
emoji: 🐠
colorFrom: indigo
colorTo: blue
sdk: static
pinned: true
---
# 3D-Arena

![3D-Arena Logo](image.png)

Hello, welcome to the 3D-Arena org!

This organization hosts the [3D-Arena project](https://huggingface.co/spaces/3d-arena/3d-arena), a leaderboard platform for evaluating 3D Generation models. 

# Compatibility

We currently host 3D Object models in the form of Gaussian Splats (such as .ply files, .splat files, or .obj files) and Mesh-based models (in the form of .glb files). 

# Contributing Guide

If you'd like to contribute to the leaderboard, please open a [new Community Issue](https://huggingface.co/spaces/3d-arena/3d-arena/discussions) to discuss the changes you'd like to make. 

## Adding a new model

If you'd like to contribute a new model, please provide a link to the publication/paper/blog post describing the model and/or methodology along with the licensing requirements for the generated objects. Please follow the steps below:

1. The [Arena dataset](https://huggingface.co/datasets/3d-arena/3d-arena) is available for download and use under the MIT License. Please run your model with the images available in this dataset
2. You must store the thumbnails for the models you generate in PNG format, with your object filenames matching the same name as that of the input image and the thumbnail. Your object models may be stored in any of the supported formats (GLB, PLY, OBJ, and SPLAT). For example, if your input image is `inputs/images/a_cat.png`, your output folder should contain `outputs/<your-model-name>/a_cat.png` and `outputs/<your-model-name>/a_cat.glb` as well.
3. Create a new [Pull Request under the Dataset repository](https://huggingface.co/datasets/3d-arena/3d-arena/discussions) and add your PNGs and Object models under `outputs/<your-model-name>`.
4. Inside your model's outputs folder, create a `config.json` file that contains data following the [schema given here as an example](https://huggingface.co/datasets/3d-arena/3d-arena/blob/main/outputs/SAM-3D-Objects-3DGS/config.json).
5. Submit the PR, someone from the org will review and merge if everything looks good!

# Citation

```
@misc{ebert20253darenaopenplatform,
      title={3D Arena: An Open Platform for Generative 3D Evaluation}, 
      author={Dylan Ebert},
      year={2025},
      eprint={2506.18787},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2506.18787}, 
}
```