---
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.