feat: support Python 3.14 and drop Python 3.9

- Add Python 3.14 to classifiers and the CI test matrix.
- Drop Python 3.9: requires-python is now >=3.10, the 3.9 classifier,
  the onnxruntime pin for <3.10, and the 3.9 CI matrix entries are removed.
- Target py310 for ruff and black; modernize annotations
  (Optional/Union -> X | None, isinstance tuples -> X | Y) and add
  explicit zip strict=False.
- Regenerate uv.lock.
- Point repository URLs at withoutbg-python.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>

Author: Imran Kocabiyik

.github/workflows/ci.yml

@@ -11,12 +11,12 @@ jobs:
     if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v7
         with:
           python-version: '3.11'
 
@@ -31,19 +31,13 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
-        exclude:
-          # Reduce matrix for faster CI
-          - os: windows-latest
-            python-version: '3.9'
-          - os: macos-latest
-            python-version: '3.9'
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v7
       with:
         python-version: ${{ matrix.python-version }}
 
@@ -66,19 +60,19 @@ jobs:
 
     - name: Upload coverage to Codecov
       if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
-      uses: codecov/codecov-action@v3
+      uses: codecov/codecov-action@v7
       with:
-        file: ./coverage.xml
+        files: ./coverage.xml
         token: ${{ secrets.CODECOV_TOKEN }}
         fail_ci_if_error: true
 
   security:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v7
       with:
         python-version: '3.11'
 
@@ -96,7 +90,7 @@ jobs:
       run: bandit -r src/ -f json -o bandit-report.json || true
 
     - name: Upload security results
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: bandit-results
         path: bandit-report.json

.github/workflows/release.yml

@@ -19,10 +19,10 @@ jobs:
     name: Quality gate
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v7
         with:
           python-version: '3.11'
 
@@ -49,13 +49,13 @@ jobs:
       new_release_version: ${{ steps.semantic.outputs.new_release_version }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
           persist-credentials: false
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v7
         with:
           node-version: '20'
           cache: npm
@@ -65,7 +65,7 @@ jobs:
 
       - name: Run semantic-release
         id: semantic
-        uses: cycjimmy/semantic-release-action@v4
+        uses: cycjimmy/semantic-release-action@v8
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
@@ -82,12 +82,12 @@ jobs:
       url: https://pypi.org/project/withoutbg/
     steps:
       - name: Checkout release tag
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           ref: v${{ needs.release.outputs.new_release_version }}
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v7
         with:
           python-version: '3.11'
 

CONTRIBUTING.md

@@ -5,8 +5,8 @@ Contributions are welcome. This document covers everything you need to get from
 ## Quick setup
 
 ```bash
-git clone https://github.com/withoutbg/withoutbg
-cd withoutbg
+git clone https://github.com/withoutbg/withoutbg-python
+cd withoutbg-python
 
 # Recommended: install with uv
 uv sync --extra dev
@@ -125,7 +125,7 @@ Use the [pull request template](.github/PULL_REQUEST_TEMPLATE.md). Keep PRs focu
 
 ## Reporting bugs
 
-Open an [issue](https://github.com/withoutbg/withoutbg/issues) using the bug report template. Include:
+Open an [issue](https://github.com/withoutbg/withoutbg-python/issues) using the bug report template. Include:
 
 - Python version and OS
 - Whether you are using **Local** (`open_weights()`) or **Cloud** (`api()`)

README.md

@@ -6,7 +6,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/withoutbg.svg)](https://pypi.org/project/withoutbg/)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![CI](https://github.com/withoutbg/withoutbg/actions/workflows/ci.yml/badge.svg)](https://github.com/withoutbg/withoutbg/actions/workflows/ci.yml)
+[![CI](https://github.com/withoutbg/withoutbg-python/actions/workflows/ci.yml/badge.svg)](https://github.com/withoutbg/withoutbg-python/actions/workflows/ci.yml)
 
 Same API for both paths: run open weights on your machine (private, offline, unlimited) or call the Cloud API (sharper edges on hair and fur, no local GPU). Built for scripts, notebooks, backends, and batch jobs.
 
@@ -249,6 +249,6 @@ See [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) for complete attribution.
 
 ## Support
 
-- **Bugs / questions:** [GitHub Issues](https://github.com/withoutbg/withoutbg/issues)
+- **Bugs / questions:** [GitHub Issues](https://github.com/withoutbg/withoutbg-python/issues)
 - **Commercial:** [contact@withoutbg.com](mailto:contact@withoutbg.com)
 - **Security:** [contact@withoutbg.com](mailto:contact@withoutbg.com) (see [SECURITY.md](SECURITY.md))

pyproject.toml

@@ -7,7 +7,7 @@ name = "withoutbg"
 dynamic = ["version"]
 description = "Python SDK for local and cloud background removal"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = {text = "Apache-2.0"}
 authors = [
     {name = "withoutbg", email = "contact@withoutbg.com"}
@@ -29,18 +29,17 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
     "Topic :: Multimedia :: Graphics :: Graphics Conversion",
 ]
 dependencies = [
     "numpy>=1.21.0",
     "pillow>=8.0.0",
-    "onnxruntime>=1.12.0,<1.20; python_version < '3.10'",
     "onnxruntime>=1.12.0,<1.24; python_version == '3.10.*'",
     "onnxruntime>=1.12.0; python_version >= '3.11'",
     "requests>=2.25.0",
@@ -65,10 +64,10 @@ dev = [
 
 [project.urls]
 Homepage = "https://withoutbg.com"
-Repository = "https://github.com/withoutbg/withoutbg"
+Repository = "https://github.com/withoutbg/withoutbg-python"
 Documentation = "https://withoutbg.com/docs/open-model/python"
-"Bug Reports" = "https://github.com/withoutbg/withoutbg/issues"
-Changelog = "https://github.com/withoutbg/withoutbg/blob/main/CHANGELOG.md"
+"Bug Reports" = "https://github.com/withoutbg/withoutbg-python/issues"
+Changelog = "https://github.com/withoutbg/withoutbg-python/blob/main/CHANGELOG.md"
 "Docker / Self-Hosted" = "https://github.com/withoutbg/withoutbg-inference"
 
 [project.scripts]
@@ -104,11 +103,11 @@ include = [
 
 [tool.black]
 line-length = 88
-target-version = ['py39']
+target-version = ['py310']
 
 [tool.ruff]
 line-length = 88
-target-version = "py39"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = [

src/withoutbg/api.py

@@ -2,8 +2,9 @@
 
 import base64
 import io
+from collections.abc import Callable
 from pathlib import Path
-from typing import Any, Callable, Optional, Union
+from typing import Any
 
 import requests
 from PIL import Image
@@ -16,7 +17,7 @@ class WithoutBGAPIClient:
     """Client for the withoutBG API."""
 
     def __init__(
-        self, api_key: Optional[str] = None, base_url: str = "https://api.withoutbg.com"
+        self, api_key: str | None = None, base_url: str = "https://api.withoutbg.com"
     ):
         """Initialize the withoutBG API client.
 
@@ -31,9 +32,9 @@ def __init__(
         if api_key:
             self.session.headers.update({"X-API-Key": api_key})
 
-    def _encode_image(self, image: Union[str, Path, Image.Image, bytes]) -> str:
+    def _encode_image(self, image: str | Path | Image.Image | bytes) -> str:
         """Encode image to base64 for API transmission."""
-        if isinstance(image, (str, Path)):
+        if isinstance(image, str | Path):
             with open(image, "rb") as f:
                 image_bytes = f.read()
         elif isinstance(image, Image.Image):
@@ -117,8 +118,8 @@ def _apply_alpha_channel(
 
     def remove_background(
         self,
-        input_image: Union[str, Path, Image.Image, bytes],
-        progress_callback: Optional[Callable] = None,
+        input_image: str | Path | Image.Image | bytes,
+        progress_callback: Callable | None = None,
         **kwargs: Any,
     ) -> Image.Image:
         """Remove background using the withoutBG API.
@@ -142,7 +143,7 @@ def remove_background(
                 progress_callback(0.1)
 
             # Store original image for local alpha application
-            if isinstance(input_image, (str, Path)):
+            if isinstance(input_image, str | Path):
                 with Image.open(input_image) as img:
                     original_image = img.copy()
             elif isinstance(input_image, Image.Image):

src/withoutbg/cli.py

@@ -3,7 +3,7 @@
 import sys
 import warnings
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 import click
 from click._termui_impl import ProgressBar
@@ -59,12 +59,12 @@
 @click.version_option(version=__version__)
 def main(
     input_path: Path,
-    output: Optional[Path],
-    api_key: Optional[str],
+    output: Path | None,
+    api_key: str | None,
     use_api: bool,
     model: str,
     batch: bool,
-    output_dir: Optional[Path],
+    output_dir: Path | None,
     format: str,
     quality: int,
     verbose: bool,
@@ -158,7 +158,7 @@ def main(
 def _process_single(
     model: WithoutBG,
     input_path: Path,
-    output_path: Optional[Path],
+    output_path: Path | None,
     format: str,
     quality: int,
     verbose: bool,
@@ -223,7 +223,7 @@ def progress_callback(progress: float) -> None:
 def _process_batch(
     model: WithoutBG,
     input_dir: Path,
-    output_dir: Optional[Path],
+    output_dir: Path | None,
     format: str,
     quality: int,
     verbose: bool,