README.md

---
title: Floor Visualizer
emoji: 🏆
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
license: mit
short_description: Visualize custom texture or tiles on your floor
---

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

## Local setup

The Python virtual environment is disposable. To recreate it after deleting `.venv`,
use the platform-specific commands in [SETUP.md](SETUP.md).

Quick macOS CPU run:

```bash
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements-mac.txt
VISUALIZER_CONFIG=visualizer.local.toml uvicorn app:app --host 0.0.0.0 --port 7860
```

GPU run:

```bash
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install --index-url https://download.pytorch.org/whl/cu126 torch==2.7.0 torchvision==0.22.0
python -m pip install -r requirements-base.txt
VISUALIZER_CONFIG=visualizer.gpu.toml uvicorn app:app --host 0.0.0.0 --port 7860
```