https://github.com/andrewrgarcia/voxels4all
https://github.com/andrewrgarcia/voxels4all
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/andrewrgarcia/voxels4all
- Owner: andrewrgarcia
- Created: 2025-01-31T17:38:31.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-31T17:47:50.000Z (4 months ago)
- Last Synced: 2025-04-05T06:29:27.432Z (about 2 months ago)
- Homepage: https://voxelvision.vercel.app/
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Voxels4All: The Open Voxel-Based 3D Dataset (In development)
Welcome to **Voxels4All**, a community-driven dataset of **3D voxel models** collected through [`Voxel Vision`](https://voxelvision.vercel.app/), an interactive web-based platform where users can create and contribute labeled voxel models for open machine learning research.
Legal & Terms of Use: See [LEGAL.md](./legal/LEGAL.md)
---
## About Voxels4All
Voxels4All is an open 3D dataset designed to support AI research and machine learning projects that require structured voxel-based representations. It serves as a scalable alternative to traditional 2D image datasets, enabling:
- User-driven category expansion – Contributors can define and add new types of voxel objects.
- Lightweight and structured format – Models are stored efficiently for portability and scalability.
- Seamless AI integration – Designed for 3D CNNs and TensorFlow.js training.
Each voxel model entry includes:
- A structured JSON or TXT representation of voxel placements and colors.
- A public file link (hosted on GitHub).
- A user-provided label/title to categorize models.
- A timestamp indicating submission time.
---
## How to Contribute
You can submit your voxel-based 3D models directly through [`Voxel Vision`](https://voxelvision.vercel.app/):
1. Design your voxel model in the Voxel Vision editor.
2. Click the Save Model button and provide a label/title.
3. Select "Submit to Dataset" when prompted.
4. Your model will be added to this GitHub repository for public access and AI training.
For details on dataset format and structure, refer to [LEGAL.md](./legal/LEGAL.md).
---
## Dataset Format
Voxels4All models are stored in structured JSON or TXT format, making them easy to load for machine learning.
Example format (`.json`):
```json
{
"size": [16, 16, 16],
"voxels": [
{ "x": 0, "y": 0, "z": 3, "color": "000000" },
{ "x": 7, "y": 0, "z": 6, "color": "FF0000" }
]
}
```
Example format (`.txt`):
```
# voxelvision.vercel.app
# X Y Z RRGGBB
0 0 3 000000
7 0 6 FF0000
```
---
## Using the Dataset
The dataset is open-source and can be used in AI research, 3D deep learning, and generative modeling.
To access the dataset:
1. Clone the repository:
```bash
git clone https://github.com/yourrepo/voxels4all.git
```
2. Use the JSON/TXT files for AI model training.
3. Contribute back by submitting improved voxel models.
---
## Feedback & Contributions
Have ideas for improvement? Encountered an issue?
We welcome feedback! Open a discussion or report an issue in our [Issues section](https://github.com/yourrepo/voxels4all/issues).
---
📌 Voxel Vision & Voxels4All are built to democratize 3D AI dataset creation. Join the community and help shape the future of **open-source voxel-based AI research!** 🌍🚀