Merge branch 'main' into feat/change-default-urls-to-serverless

Author: yeldarby

.devcontainer/devcontainer.json

@@ -3,6 +3,7 @@
     "dockerComposeFile": "./docker-compose.yaml",
     "service": "devcontainer-roboflow-python",
     "workspaceFolder": "/roboflow-python",
+    "initializeCommand": "sh -lc 'mkdir -p .devcontainer/certs; if command -v mkcert >/dev/null 2>&1; then CAROOT=\"$(mkcert -CAROOT)\"; if [ -f \"$CAROOT/rootCA.pem\" ]; then cp \"$CAROOT/rootCA.pem\" .devcontainer/certs/mkcert-rootCA.crt; else echo \"[devcontainer] mkcert CA not found at $CAROOT/rootCA.pem; skipping\"; fi; else echo \"[devcontainer] mkcert not installed; skipping CA copy\"; fi'",
     "postStartCommand": "git config --global --add safe.directory ${containerWorkspaceFolder}",
     "customizations": {
         "vscode": {

.devcontainer/docker-compose.yaml

@@ -5,6 +5,8 @@ services:
       context: ..
       dockerfile: Dockerfile.dev
     image: devcontainer-roboflow-python
+    extra_hosts:
+      - "localhost.roboflow.one:host-gateway"
     volumes:
       - ..:/roboflow-python
     command: sleep infinity

.github/workflows/test.yml

@@ -8,10 +8,13 @@ on:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        os: ["ubuntu-latest", "windows-latest"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    runs-on: ${{ matrix.os }}
+    env:
+      PYTHONUTF8: 1
 
     steps:
       - name: 🛎️ Checkout

.gitignore

@@ -8,6 +8,7 @@ __pycache__/
 .idea
 # C extensions
 *.so
+.devcontainer/certs/
 
 # Distribution / packaging
 .Python
@@ -154,3 +155,4 @@ tests/manual/data
 README.roboflow.txt
 *.zip
 .DS_Store
+.claude

.pre-commit-config.yaml

@@ -6,7 +6,7 @@ ci:
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict
@@ -24,14 +24,14 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.7.9
+    rev: 1.8.3
     hooks:
       - id: bandit
         args: ["-c", "pyproject.toml"]
         additional_dependencies: ["bandit[toml]"]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.4
+    rev: v0.11.12
     hooks:
       - id: ruff-format
       - id: ruff

CLAUDE.md

@@ -0,0 +1,115 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+### Running Tests
+```bash
+python -m unittest
+```
+
+### Linting and Code Quality
+```bash
+# Format code with ruff
+make style
+
+# Check code quality (includes ruff and mypy)
+make check_code_quality
+
+# Individual commands
+ruff format roboflow
+ruff check roboflow --fix
+mypy roboflow
+```
+
+### Building Documentation
+```bash
+# Install documentation dependencies
+python -m pip install mkdocs mkdocs-material mkdocstrings mkdocstrings[python]
+
+# Serve documentation locally
+mkdocs serve
+```
+
+### Installing Development Environment
+```bash
+# Create virtual environment
+python3 -m venv env
+source env/bin/activate
+
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+pip install pre-commit
+pre-commit install
+```
+
+## Architecture Overview
+
+The Roboflow Python SDK follows a hierarchical object model that mirrors the Roboflow platform structure:
+
+### Core Components
+
+1. **Roboflow** (`roboflow/__init__.py`) - Entry point and authentication
+   - Handles API key management and workspace initialization
+   - Provides `login()` for CLI authentication
+   - Creates workspace connections
+
+2. **Workspace** (`roboflow/core/workspace.py`) - Manages Roboflow workspaces
+   - Lists and accesses projects
+   - Handles dataset uploads and model deployments
+   - Manages workspace-level operations
+
+3. **Project** (`roboflow/core/project.py`) - Represents a computer vision project
+   - Manages project metadata and versions
+   - Handles image/annotation uploads
+   - Supports different project types (object-detection, classification, etc.)
+
+4. **Version** (`roboflow/core/version.py`) - Dataset version management
+   - Downloads datasets in various formats
+   - Deploys models
+   - Provides access to trained models for inference
+
+5. **Model Classes** (`roboflow/models/`) - Type-specific inference models
+   - `ObjectDetectionModel` - Bounding box predictions
+   - `ClassificationModel` - Image classification
+   - `InstanceSegmentationModel` - Pixel-level segmentation
+   - `SemanticSegmentationModel` - Class-based segmentation
+   - `KeypointDetectionModel` - Keypoint predictions
+
+### API Adapters
+
+- **rfapi** (`roboflow/adapters/rfapi.py`) - Low-level API communication
+- **deploymentapi** (`roboflow/adapters/deploymentapi.py`) - Model deployment operations
+
+### CLI Interface
+
+The `roboflow` command line tool (`roboflow/roboflowpy.py`) provides:
+- Authentication: `roboflow login`
+- Dataset operations: `roboflow download`, `roboflow upload`, `roboflow import`
+- Inference: `roboflow infer`
+- Project/workspace management: `roboflow project`, `roboflow workspace`
+
+### Key Design Patterns
+
+1. **Hierarchical Access**: Always access objects through their parent (Workspace → Project → Version → Model)
+2. **API Key Flow**: API key is passed down through the object hierarchy
+3. **Format Flexibility**: Supports multiple dataset formats (YOLO, COCO, Pascal VOC, etc.)
+4. **Batch Operations**: Upload and download operations support concurrent processing
+
+## Project Configuration
+
+- **Python Version**: 3.8+
+- **Main Dependencies**: See `requirements.txt`
+- **Entry Point**: `roboflow=roboflow.roboflowpy:main`
+- **Code Style**: Enforced by ruff with Google docstring convention
+- **Type Checking**: mypy configured for Python 3.8
+
+## Important Notes
+
+- API keys are stored in `~/.config/roboflow/config.json` (Unix) or `~/roboflow/config.json` (Windows)
+- The SDK supports both hosted inference (Roboflow platform) and local inference (via Roboflow Inference)
+- Pre-commit hooks automatically run formatting and linting checks
+- Test files intentionally excluded from linting: `tests/manual/debugme.py`

Dockerfile.dev

@@ -1,9 +1,25 @@
-FROM python:3.8
-RUN apt-get update && apt-get install -y make libgl1-mesa-glx && rm -rf /var/lib/apt/lists/*
+FROM python:3.10
+RUN apt-get update && apt-get install -y make curl libgl1-mesa-glx ca-certificates && rm -rf /var/lib/apt/lists/*
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:${PATH}"
+
+
 WORKDIR /roboflow-python
 COPY .devcontainer/bashrc_ext /root/bashrc_ext
 RUN echo "source /root/bashrc_ext" >> ~/.bashrc
-COPY ./setup.py ./pyproject.toml ./README.md ./requirements.txt ./
+
+# Trust any custom CAs provided in build context (e.g., mkcert)
+COPY .devcontainer/certs/ /usr/local/share/ca-certificates/
+RUN update-ca-certificates || true
+ENV SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
+ENV REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
+
+
+COPY ./requirements.txt ./
+RUN uv pip install --system -r requirements.txt
+
+COPY ./setup.py ./pyproject.toml ./README.md ./
 COPY roboflow/__init__.py ./roboflow/__init__.py
-RUN pip install -e ".[dev]"
+RUN uv pip install --system -e ".[dev]"
+
 COPY . .

pyproject.toml

@@ -7,7 +7,7 @@ target = ["test", "roboflow"]
 tests = ["B201", "B301"]
 
 [tool.ruff]
-target-version = "py38"
+target-version = "py39"
 line-length = 120
 
 [tool.ruff.lint]
@@ -32,6 +32,7 @@ ignore = [
     "N",
     "PERF",
     "PIE",
+    "PLC0415",  # `import` should be at the top-level of a file
     "PLR",
     "PLW",
     "PT",
@@ -44,6 +45,7 @@ ignore = [
     "T",
     "TD",
     "TRY",
+    "UP",
 ]
 
 # Exclude a variety of commonly ignored directories.
@@ -99,7 +101,7 @@ banned-module-level-imports = [
 ]
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.9"
 exclude = ["^build/"]
 
 [[tool.mypy.overrides]]
@@ -110,9 +112,6 @@ module = [
     "IPython.display.*",
     # ipywidgets is an optional dependency
     "ipywidgets.*",
-    # matplotlib typing is not available for Python 3.8
-    # remove this when we stop supporting Python 3.8
-    "matplotlib.*",
     "requests_toolbelt.*",
     "torch.*",
     "ultralytics.*",

requirements.txt

@@ -6,7 +6,9 @@ matplotlib
 numpy>=1.18.5
 opencv-python-headless==4.10.0.84
 Pillow>=7.1.2
-pillow-heif>=0.18.0
+# https://github.com/roboflow/roboflow-python/issues/390
+pi-heif<2
+pillow-avif-plugin<2
 python-dateutil
 python-dotenv
 requests

roboflow/__init__.py

@@ -15,7 +15,7 @@
 from roboflow.models import CLIPModel, GazeModel  # noqa: F401
 from roboflow.util.general import write_line
 
-__version__ = "1.1.61"
+__version__ = "1.2.9"
 
 
 def check_key(api_key, model, notebook, num_retries=0):