sanghan commited on
Commit
e62763c
·
1 Parent(s): 87f99de

updated readme

Browse files
Files changed (1) hide show
  1. README.md +63 -0
README.md CHANGED
@@ -9,6 +9,69 @@ app_file: app.py
9
  pinned: false
10
  ---
11
 
 
 
12
  Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
13
 
14
  ![gradio](./assets/gradio.png)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9
  pinned: false
10
  ---
11
 
12
+ # STL2GLB
13
+
14
  Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
15
 
16
  ![gradio](./assets/gradio.png)
17
+
18
+ ## Overview
19
+
20
+ 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.
21
+
22
+ ## Features
23
+
24
+ - Convert 3D models from STL to GLB format.
25
+ - Clean up temporary files created during conversion.
26
+ - Interactive model uploader and viewer using [Gradio](https://gradio.app).
27
+
28
+ # Getting Started
29
+
30
+ ## Prerequisites
31
+
32
+ - Python 3.10 or newer.
33
+ - [Git LFS](https://git-lfs.github.com/) installed to work with large STL files.
34
+ - Docker (optional) for containerized deployment.
35
+
36
+ ## Installation
37
+
38
+ 1. Clone the repository:
39
+
40
+ ```bash
41
+ git clone https://github.com/Hal51AI/STL2GLB.git
42
+ cd STL2GLB
43
+ ```
44
+
45
+ 2. Install dependencies:
46
+
47
+ ```bash
48
+ pip install -r requirements.txt
49
+ ```
50
+
51
+ ## Running the Application Locally
52
+
53
+ Run the application using Python:
54
+
55
+ ```bash
56
+ python app.py
57
+ ```
58
+
59
+ 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.
60
+
61
+ ## Running with Docker
62
+
63
+ 1. Build the Docker image:
64
+
65
+ ```bash
66
+ docker build -t stl2glb .
67
+ ```
68
+
69
+ 2. Run the Docker container:
70
+
71
+ ```bash
72
+ docker run -p 7860:7860 stl2glb
73
+ ```
74
+
75
+ The application will be available at http://0.0.0.0:7860.
76
+
77
+