Sync from GitHub via hub-sync

.python-version

@@ -0,0 +1 @@
+3.12

Agents.md

@@ -0,0 +1,21 @@
+## Python Environment
+
+Always use uv to run Python scripts and manage dependencies -- never use pip or python directly.
+
+Run scripts with `uv run python script.py` instead of `python script.py`.
+
+Install packages with `uv add package-name` instead of `pip install`.
+
+To run one-off commands: `uv run <command>`.
+
+The project uses uv for virtual environment management; do not create venvs manually with `python -m venv`.
+
+## Common Commands
+
+`uv run python script.py` -- run a script
+
+`uv add <package>` -- add a dependency
+
+`uv sync` -- install all dependencies from lockfile
+
+`uv run pytest` -- run tests

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CyGuy8
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,15 +1,38 @@
 ---
 title: PicRotate
-emoji: 📈
-colorFrom: red
-colorTo: green
 sdk: gradio
-sdk_version: 6.16.0
-python_version: '3.13'
+sdk_version: 4.44.1
+python_version: 3.12
 app_file: app.py
 pinned: false
 license: mit
-short_description: Rotates a Picture
+short_description: Rotate images by 90 degrees or any custom angle.
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# PicRotate
+
+Rotate an image from a file upload or pasted clipboard image using Gradio.
+
+## Hugging Face Spaces
+
+This repository is ready for a Gradio Space. The required Space components are:
+
+- `README.md` metadata block with `sdk: gradio`, `sdk_version: 4.44.1`, `python_version: 3.12`, and `app_file: app.py`
+- `app.py` as the Gradio application entry point
+- `requirements.txt` for Python dependencies installed by the Space runtime
+
+Create a Hugging Face Space with the Gradio SDK, then push these files to the Space repository. The Space will build and launch `app.py` automatically.
+
+## Requirements
+
+- `gradio==4.44.1`
+- `pillow>=10.0.0`
+- `huggingface-hub<1.0.0`
+- `pydantic==2.10.6`
+
+## Run
+
+```powershell
+uv sync
+uv run python app.py
+```

app.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+from typing import Literal
+
+import gradio as gr
+from PIL import Image
+
+RotationMode = Literal["Clockwise 90", "Counterclockwise 90", "Custom angle"]
+
+
+def rotate_image(
+    image: Image.Image | None,
+    rotation_mode: RotationMode,
+    custom_angle: float | None,
+) -> Image.Image | None:
+    if image is None:
+        return None
+
+    if rotation_mode == "Clockwise 90":
+        angle = -90
+    elif rotation_mode == "Counterclockwise 90":
+        angle = 90
+    else:
+        angle = -(custom_angle or 0)
+
+    return image.rotate(
+        angle,
+        expand=True,
+        resample=Image.Resampling.BICUBIC,
+        fillcolor=(255, 255, 255, 0) if image.mode == "RGBA" else None,
+    )
+
+
+def show_custom_angle(rotation_mode: RotationMode):
+    return gr.update(visible=rotation_mode == "Custom angle")
+
+
+def build_app() -> gr.Blocks:
+    with gr.Blocks(title="PicRotate", theme=gr.themes.Soft()) as demo:
+        gr.Markdown("# PicRotate")
+
+        with gr.Row():
+            input_image = gr.Image(
+                label="Image",
+                sources=["upload", "clipboard"],
+                type="pil",
+                image_mode="RGBA",
+                height=460,
+            )
+            output_image = gr.Image(
+                label="Rotated image",
+                type="pil",
+                image_mode="RGBA",
+                height=460,
+            )
+
+        with gr.Row():
+            rotation_mode = gr.Radio(
+                choices=["Clockwise 90", "Counterclockwise 90", "Custom angle"],
+                value="Clockwise 90",
+                label="Rotation",
+            )
+            custom_angle = gr.Number(
+                value=45,
+                label="Custom angle in degrees clockwise",
+                precision=2,
+                visible=False,
+            )
+
+        rotate_button = gr.Button("Rotate", variant="primary")
+        rotation_mode.change(
+            fn=show_custom_angle,
+            inputs=rotation_mode,
+            outputs=custom_angle,
+        )
+        rotate_button.click(
+            fn=rotate_image,
+            inputs=[input_image, rotation_mode, custom_angle],
+            outputs=output_image,
+        )
+
+    return demo
+
+
+if __name__ == "__main__":
+    build_app().launch()

pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "picrotate"
+version = "0.1.0"
+description = "A Gradio app for rotating images."
+readme = "README.md"
+requires-python = ">=3.10,<3.13"
+dependencies = [
+    "gradio==4.44.1",
+    "huggingface-hub<1.0.0",
+    "pillow>=10.0.0",
+    "pydantic==2.10.6",
+]
+
+[tool.uv]
+package = false

requirements.txt

@@ -0,0 +1,4 @@
+gradio==4.44.1
+huggingface-hub<1.0.0
+pillow>=10.0.0
+pydantic==2.10.6