Update

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v6.0.0
     hooks:
       - id: check-executables-have-shebangs
       - id: check-json
@@ -13,48 +13,21 @@ repos:
         args: ["--fix=lf"]
       - id: requirements-txt-fixer
       - id: trailing-whitespace
-  - repo: https://github.com/myint/docformatter
-    rev: v1.7.5
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.12
     hooks:
-      - id: docformatter
-        args: ["--in-place"]
-  - repo: https://github.com/pycqa/isort
-    rev: 5.13.2
-    hooks:
-      - id: isort
-        args: ["--profile", "black"]
+      - id: ruff-check
+        args: ["--fix"]
+      - id: ruff-format
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.10.0
+    rev: v1.17.1
     hooks:
       - id: mypy
         args: ["--ignore-missing-imports"]
         additional_dependencies:
           [
             "types-python-slugify",
-            "types-requests",
-            "types-PyYAML",
             "types-pytz",
+            "types-PyYAML",
+            "types-requests",
           ]
-  - repo: https://github.com/psf/black
-    rev: 24.4.2
-    hooks:
-      - id: black
-        language_version: python3.10
-        args: ["--line-length", "119"]
-  - repo: https://github.com/kynan/nbstripout
-    rev: 0.7.1
-    hooks:
-      - id: nbstripout
-        args:
-          [
-            "--extra-keys",
-            "metadata.interpreter metadata.kernelspec cell.metadata.pycharm",
-          ]
-  - repo: https://github.com/nbQA-dev/nbQA
-    rev: 1.8.5
-    hooks:
-      - id: nbqa-black
-      - id: nbqa-pyupgrade
-        args: ["--py37-plus"]
-      - id: nbqa-isort
-        args: ["--float-to-top"]

.python-version

@@ -0,0 +1 @@
+3.10

.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+    "recommendations": [
+        "ms-python.python",
+        "charliermarsh.ruff",
+        "streetsidesoftware.code-spell-checker",
+        "tamasfe.even-better-toml"
+    ]
+}

.vscode/settings.json

@@ -2,29 +2,16 @@
     "editor.formatOnSave": true,
     "files.insertFinalNewline": false,
     "[python]": {
-        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.defaultFormatter": "charliermarsh.ruff",
         "editor.formatOnType": true,
         "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "explicit",
             "source.organizeImports": "explicit"
         }
     },
     "[jupyter]": {
         "files.insertFinalNewline": false
     },
-    "black-formatter.args": [
-        "--line-length=119"
-    ],
-    "isort.args": ["--profile", "black"],
-    "flake8.args": [
-        "--max-line-length=119"
-    ],
-    "ruff.lint.args": [
-        "--line-length=119"
-    ],
     "notebook.output.scrolling": true,
-    "notebook.formatOnCellExecution": true,
-    "notebook.formatOnSave.enabled": true,
-        "notebook.codeActionsOnSave": {
-            "source.organizeImports": "explicit"
-        }
+    "notebook.formatOnSave.enabled": true
 }

README.md

@@ -4,7 +4,7 @@ emoji: 📚
 colorFrom: purple
 colorTo: yellow
 sdk: gradio
-sdk_version: 4.36.1
+sdk_version: 5.44.1
 app_file: app.py
 pinned: false
 short_description: head pose estimation

app.py

@@ -1,9 +1,7 @@
 #!/usr/bin/env python
 
-from __future__ import annotations
-
 import sys
-from typing import Callable
+from collections.abc import Callable
 
 import cv2
 import gradio as gr
@@ -12,17 +10,17 @@ import numpy as np
 import PIL.Image
 import spaces
 import torch
-import torch.nn as nn
-import torch.nn.functional as F
+import torch.nn.functional as F  # noqa: N812
 import torchvision
-import torchvision.transforms as T
+import torchvision.transforms as T  # noqa: N812
 from scipy.spatial.transform import Rotation
+from torch import nn
 
 sys.path.insert(0, "face_detection")
 sys.path.insert(0, "deep-head-pose/code")
 
-from hopenet import Hopenet
-from ibug.face_detection import RetinaFacePredictor
+from hopenet import Hopenet  # pyright: ignore[reportMissingImports]
+from ibug.face_detection import RetinaFacePredictor  # pyright: ignore[reportMissingImports]
 
 DESCRIPTION = "# [Hopenet](https://github.com/natanielruiz/deep-head-pose)"
 
@@ -38,7 +36,7 @@ def load_model(model_name: str, device: torch.device) -> nn.Module:
 
 
 def create_transform() -> Callable:
-    transform = T.Compose(
+    return T.Compose(
         [
             T.Resize(224),
             T.CenterCrop(224),
@@ -46,7 +44,6 @@ def create_transform() -> Callable:
             T.Normalize(mean=[0.485, 0.456, 0.406], std=[0.229, 0.224, 0.225]),
         ]
     )
-    return transform
 
 
 def crop_face(image: np.ndarray, box: tuple[int, int, int, int]) -> np.ndarray:
@@ -61,8 +58,7 @@ def crop_face(image: np.ndarray, box: tuple[int, int, int, int]) -> np.ndarray:
     y0 = max(y0, 0)
     x1 = min(x1, image.shape[1])
     y1 = min(y1, image.shape[0])
-    image = image[y0:y1, x0:x1]
-    return image
+    return image[y0:y1, x0:x1]
 
 
 def draw_axis(image: np.ndarray, pose: np.ndarray, origin: np.ndarray, length: int) -> None:
@@ -134,13 +130,13 @@ def run(
 
 examples = [["images/pexels-ksenia-chernaya-8535230.jpg", "hopenet_alpha1"]]
 
-with gr.Blocks(css="style.css") as demo:
+with gr.Blocks(css_paths="style.css") as demo:
     gr.Markdown(DESCRIPTION)
     with gr.Row():
         with gr.Column():
             image = gr.Image(label="Input", type="numpy")
             model_name = gr.Radio(label="Model", choices=model_names, type="value", value=model_names[0])
-            run_button = gr.Button("Run")
+            run_button = gr.Button()
         with gr.Column():
             result = gr.Image(label="Output")
     gr.Examples(
@@ -153,8 +149,7 @@ with gr.Blocks(css="style.css") as demo:
         fn=run,
         inputs=[image, model_name],
         outputs=result,
-        api_name="run",
     )
 
 if __name__ == "__main__":
-    demo.queue().launch()
+    demo.launch()

pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "hopenet"
+version = "0.1.0"
+description = ""
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "gradio>=5.44.1",
+    "hf-transfer>=0.1.9",
+    "opencv-python-headless>=4.12.0.88",
+    "scipy>=1.15.3",
+    "spaces>=0.40.1",
+    "torch==2.8.0",
+    "torchvision>=0.23.0",
+]
+
+[tool.ruff]
+line-length = 119
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "COM812", # missing-trailing-comma
+    "D203",   # one-blank-line-before-class
+    "D213",   # multi-line-summary-second-line
+    "E501",   # line-too-long
+    "SIM117", # multiple-with-statements
+    #
+    "D100",    # undocumented-public-module
+    "D101",    # undocumented-public-class
+    "D102",    # undocumented-public-method
+    "D103",    # undocumented-public-function
+    "D104",    # undocumented-public-package
+    "D105",    # undocumented-magic-method
+    "D107",    # undocumented-public-init
+    "EM101",   # raw-string-in-exception
+    "FBT001",  # boolean-type-hint-positional-argument
+    "FBT002",  # boolean-default-value-positional-argument
+    "PD901",   # pandas-df-variable-name
+    "PGH003",  # blanket-type-ignore
+    "PLR0913", # too-many-arguments
+    "PLR0915", # too-many-statements
+    "TRY003",  # raise-vanilla-args
+]
+unfixable = [
+    "F401", # unused-import
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"*.ipynb" = ["T201", "T203"]
+
+[tool.ruff.format]
+docstring-code-format = true

requirements.txt

@@ -1,7 +1,241 @@
-gradio==4.36.1
-numpy==1.26.4
-opencv-python-headless==4.10.0.82
-Pillow==10.3.0
-scipy==1.13.1
-torch==2.0.1
-torchvision==0.15.2
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml -o requirements.txt
+aiofiles==24.1.0
+    # via gradio
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.10.0
+    # via
+    #   gradio
+    #   httpx
+    #   starlette
+brotli==1.1.0
+    # via gradio
+certifi==2025.8.3
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+charset-normalizer==3.4.3
+    # via requests
+click==8.2.1
+    # via
+    #   typer
+    #   uvicorn
+exceptiongroup==1.3.0
+    # via anyio
+fastapi==0.116.1
+    # via gradio
+ffmpy==0.6.1
+    # via gradio
+filelock==3.19.1
+    # via
+    #   huggingface-hub
+    #   torch
+fsspec==2025.9.0
+    # via
+    #   gradio-client
+    #   huggingface-hub
+    #   torch
+gradio==5.44.1
+    # via
+    #   hopenet (pyproject.toml)
+    #   spaces
+gradio-client==1.12.1
+    # via gradio
+groovy==0.1.2
+    # via gradio
+h11==0.16.0
+    # via
+    #   httpcore
+    #   uvicorn
+hf-transfer==0.1.9
+    # via hopenet (pyproject.toml)
+hf-xet==1.1.9
+    # via huggingface-hub
+httpcore==1.0.9
+    # via httpx
+httpx==0.28.1
+    # via
+    #   gradio
+    #   gradio-client
+    #   safehttpx
+    #   spaces
+huggingface-hub==0.34.4
+    # via
+    #   gradio
+    #   gradio-client
+idna==3.10
+    # via
+    #   anyio
+    #   httpx
+    #   requests
+jinja2==3.1.6
+    # via
+    #   gradio
+    #   torch
+markdown-it-py==4.0.0
+    # via rich
+markupsafe==3.0.2
+    # via
+    #   gradio
+    #   jinja2
+mdurl==0.1.2
+    # via markdown-it-py
+mpmath==1.3.0
+    # via sympy
+networkx==3.4.2
+    # via torch
+numpy==2.2.6
+    # via
+    #   gradio
+    #   opencv-python-headless
+    #   pandas
+    #   scipy
+    #   torchvision
+nvidia-cublas-cu12==12.8.4.1
+    # via
+    #   nvidia-cudnn-cu12
+    #   nvidia-cusolver-cu12
+    #   torch
+nvidia-cuda-cupti-cu12==12.8.90
+    # via torch
+nvidia-cuda-nvrtc-cu12==12.8.93
+    # via torch
+nvidia-cuda-runtime-cu12==12.8.90
+    # via torch
+nvidia-cudnn-cu12==9.10.2.21
+    # via torch
+nvidia-cufft-cu12==11.3.3.83
+    # via torch
+nvidia-cufile-cu12==1.13.1.3
+    # via torch
+nvidia-curand-cu12==10.3.9.90
+    # via torch
+nvidia-cusolver-cu12==11.7.3.90
+    # via torch
+nvidia-cusparse-cu12==12.5.8.93
+    # via
+    #   nvidia-cusolver-cu12
+    #   torch
+nvidia-cusparselt-cu12==0.7.1
+    # via torch
+nvidia-nccl-cu12==2.27.3
+    # via torch
+nvidia-nvjitlink-cu12==12.8.93
+    # via
+    #   nvidia-cufft-cu12
+    #   nvidia-cusolver-cu12
+    #   nvidia-cusparse-cu12
+    #   torch
+nvidia-nvtx-cu12==12.8.90
+    # via torch
+opencv-python-headless==4.12.0.88
+    # via hopenet (pyproject.toml)
+orjson==3.11.3
+    # via gradio
+packaging==25.0
+    # via
+    #   gradio
+    #   gradio-client
+    #   huggingface-hub
+    #   spaces
+pandas==2.3.2
+    # via gradio
+pillow==10.3.0
+    # via
+    #   gradio
+    #   torchvision
+psutil==5.9.8
+    # via spaces
+pydantic==2.11.7
+    # via
+    #   fastapi
+    #   gradio
+    #   spaces
+pydantic-core==2.33.2
+    # via pydantic
+pydub==0.25.1
+    # via gradio
+pygments==2.19.2
+    # via rich
+python-dateutil==2.9.0.post0
+    # via pandas
+python-multipart==0.0.20
+    # via gradio
+pytz==2025.2
+    # via pandas
+pyyaml==6.0.2
+    # via
+    #   gradio
+    #   huggingface-hub
+requests==2.32.5
+    # via
+    #   huggingface-hub
+    #   spaces
+rich==14.1.0
+    # via typer
+ruff==0.12.12
+    # via gradio
+safehttpx==0.1.6
+    # via gradio
+scipy==1.15.3
+    # via hopenet (pyproject.toml)
+semantic-version==2.10.0
+    # via gradio
+setuptools==80.9.0
+    # via triton
+shellingham==1.5.4
+    # via typer
+six==1.17.0
+    # via python-dateutil
+sniffio==1.3.1
+    # via anyio
+spaces==0.40.1
+    # via hopenet (pyproject.toml)
+starlette==0.47.3
+    # via
+    #   fastapi
+    #   gradio
+sympy==1.14.0
+    # via torch
+tomlkit==0.13.3
+    # via gradio
+torch==2.8.0
+    # via
+    #   hopenet (pyproject.toml)
+    #   torchvision
+torchvision==0.23.0
+    # via hopenet (pyproject.toml)
+tqdm==4.67.1
+    # via huggingface-hub
+triton==3.4.0
+    # via torch
+typer==0.17.3
+    # via gradio
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   exceptiongroup
+    #   fastapi
+    #   gradio
+    #   gradio-client
+    #   huggingface-hub
+    #   pydantic
+    #   pydantic-core
+    #   spaces
+    #   starlette
+    #   torch
+    #   typer
+    #   typing-inspection
+    #   uvicorn
+typing-inspection==0.4.1
+    # via pydantic
+tzdata==2025.2
+    # via pandas
+urllib3==2.5.0
+    # via requests
+uvicorn==0.35.0
+    # via gradio
+websockets==15.0.1
+    # via gradio-client