README.md

---
title: STL to TIFF Slicer
sdk: gradio
sdk_version: 6.10.0
python_version: "3.12"
app_file: app.py
fullWidth: true
short_description: Upload an STL and export a TIFF slice.
---

# STL to TIFF Gradio App

This project provides a Gradio app that takes an uploaded STL file, shows an interactive 3D viewer, slices it along the Z axis, saves each slice as a TIFF image, and lets you browse the stack inside the UI.

## Run

```powershell
uv sync --all-groups
uv run python app.py
```

Then open the local Gradio URL in your browser, upload an STL file, and generate the TIFF stack.

## What the app does

- Uploads a single `.stl` file
- Shows an interactive 3D viewer for rotating the model
- Lets you choose layer height and XY pixel size
- Produces one `.tif` image per slice
- Lets you step through the slice stack in the browser
- Exports a ZIP containing the generated TIFF images

## Test

```powershell
uv run pytest
```