File size: 1,576 Bytes
fd817d6
 
3ba6abe
fd817d6
 
 
 
 
 
 
 
e62763c
 
fd817d6
a070f33
 
e62763c
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
---
title: STL2GLB
emoji: πŸ“
colorFrom: gray
colorTo: red
sdk: gradio
sdk_version: 4.17.0
app_file: app.py
pinned: false
---

# STL2GLB

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

![gradio](./assets/gradio.png)

## Overview

The STL2GLB project is a simple tool that converts 3D models in STL format to GLB format. The conversion is powered by [trimesh](https://trimsh.org) and features an interactive Gradio interface. This project is containerized using Docker for easy deployment.

## Features

- Convert 3D models from STL to GLB format.
- Clean up temporary files created during conversion.
- Interactive model uploader and viewer using [Gradio](https://gradio.app).

# Getting Started

## Prerequisites

- Python 3.10 or newer.
- [Git LFS](https://git-lfs.github.com/) installed to work with large STL files.
- Docker (optional) for containerized deployment.

## Installation

1. Clone the repository:

```bash
git clone https://github.com/Hal51AI/STL2GLB.git
cd STL2GLB
```

2. Install dependencies:

```bash
pip install -r requirements.txt
```

## Running the Application Locally

Run the application using Python:

```bash
python app.py
```

This will launch the Gradio interface (by default on port 7860) where you can upload an STL file, convert it to GLB, and view the result.

## Running with Docker

1. Build the Docker image:

```bash
docker build -t stl2glb .
```

2. Run the Docker container:

```bash
docker run -p 7860:7860 stl2glb
```

The application will be available at http://0.0.0.0:7860.