Image Viewer

Flask-based image viewer with folder support and thumbnail generation.

Quick Start with UV

1. Install UV (Windows)

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

1. Install UV (Linux)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Setup Environment

# Create virtual environment
uv venv

# Activate it (Windows)
.venv\Scripts\activate

3. Install Dependencies

Option A: From pyproject.toml (Recommended)

uv pip install -e .

Option B: Direct install

uv pip install flask pillow werkzeug

4. Run the App

python app.py

Open browser: http://127.0.0.1:5000

---

Alternative: Use Setup Script

setup.bat
run.bat

Features

• Upload & organize images in folders
• Thumbnail generation
• Lightbox gallery view
• Folder navigation with breadcrumbs
• Drag-and-drop upload support