README.md

metadata

title: Image Rotator
emoji: 🔄
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 6.14.0
app_file: app.py
pinned: false

ImageRotate

This repository contains experimental scripts and applications.

🔄 Image Rotator

A beautiful, premium Gradio application for rotating images by standard steps or custom angles. It supports uploading files, drag-and-drop, and pasting images directly from the clipboard.

Features

• Flexible Inputs: Drag and drop, file browser, or paste directly from clipboard (Ctrl+V).
• One-Click Presets: Quick actions to rotate 90° CCW, 90° CW, or 180°, plus a quick Reset button.
• Custom Precision: Interactive slider to rotate by any angle between -360° and 360°.
• Advanced Canvas Settings:
  • Expand Canvas: Option to expand the output canvas to fit the rotated image or clip it to the original size.
  • Custom Background Fills: Select a transparent background (transparency layer, requires PNG export), black, white, or input a custom hex color code.
• EXIF Correction: Automatically respects camera orientation tags so images are rendered correctly.
• Modern UI: Designed using custom CSS glassmorphism, gradient banners, and a clean, responsive layout.

---

How to Run the App

This project uses uv for package and environment management. Follow these guidelines to run the application:

1. Setup Environment & Install Dependencies

First, ensure that uv is installed, then synchronize the environment.

# Sync dependencies from pyproject.toml
uv sync

Note: If you are setting up the project from scratch, you can also install the dependencies manually using:

uv add gradio pillow

2. Launch the Application

Run the Gradio server using uv run. We recommend using -u (unbuffered) so logs flush to console immediately:

uv run python -u app.py

Once running, open your web browser and navigate to: 👉 http://127.0.0.1:7860