Merge pull request #10440 from cvat-ai/release-2.62.0

Release v2.62.0

Author: cvat-bot[bot]

.regal/config.yaml

@@ -21,6 +21,9 @@ rules:
       # Mainly a style preference
       # https://docs.styra.com/regal/rules/style/avoid-get-and-list-prefix
       level: ignore
+    external-reference:
+      # https://docs.styra.com/regal/rules/style/external-reference
+      level: ignore
     opa-fmt:
       # https://docs.styra.com/regal/rules/style/opa-fmt
       level: ignore

.vscode/launch.json

@@ -420,7 +420,8 @@
                 "server: django",
                 "server: RQ - worker",
                 "server: RQ - scheduler",
-            ]
+            ],
+            "stopAll": true,
         }
     ]
 }

CHANGELOG.md

@@ -16,6 +16,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- scriv-insert-here -->
 
+<a id='changelog-2.62.0'></a>
+## \[2.62.0\] - 2026-04-02
+
+### Added
+
+- Show success notification after saving annotation guide (<https://github.com/cvat-ai/cvat/pull/10342>)
+
+- Compose for transformers + Helm support for function name env var
+  (<https://github.com/cvat-ai/cvat/pull/10388>)
+
+### Changed
+
+- The format for filters in Rego policy files has changed; if you have
+  added custom policy files, you may need to update them
+  (<https://github.com/cvat-ai/cvat/pull/10387>)
+
+- 'Remove annotations' confirmation message now more user-friendly.
+- 'Delete' button renamed to 'Remove' to match the message
+  (<https://github.com/cvat-ai/cvat/pull/10407>)
+
+- Bounding box is used as a default prompt for SAM models instead of points
+  (<https://github.com/cvat-ai/cvat/pull/10432>)
+
+- Snap to contour and snap to point features are now accessible on the controls sidebar
+  (<https://github.com/cvat-ai/cvat/pull/10421>)
+
+### Fixed
+
+- Width misalignment between top bars and content lists (tasks, jobs, projects,
+  cloud storages, webhooks pages) by applying consistent scrollbar gutter spacing.
+  (<https://github.com/cvat-ai/cvat/pull/10324>)
+
+- Content size on resource pages for smaller screens (<1000px) to provide better responsive layout
+  (<https://github.com/cvat-ai/cvat/pull/10324>)
+
+- Exported interpolated shapes in 3D cuboid tracks can have invalid rotation
+  (<https://github.com/cvat-ai/cvat/pull/10413>)
+
+- Fixed chunk generation in tasks with backing cloud storage where the
+  manifest contains incomplete paths
+  (<https://github.com/cvat-ai/cvat/pull/10429>)
+
 <a id='changelog-2.61.0'></a>
 ## \[2.61.0\] - 2026-03-20
 

_typos.toml

@@ -1,4 +1,5 @@
 files.extend-exclude = [
+    "ai-models/agents_deployment/transformers/supported_models",
     "cvat-ui/src/assets/opencv_4.8.0.js",
     "cvat-data/src/ts/3rdparty/*.js",
     "site/themes/docsy/",

ai-models/agents_deployment/helm/templates/helpers.tpl

@@ -94,3 +94,15 @@ Configure command arguments for cvat-cli
 - name: MODEL_CONFIG_PARAMS
   value: {{ $val | trim | quote }}
 {{- end -}}
+
+{{/*
+Configure function name for agent
+*/}}
+{{- define "agent.functionNameEnv" -}}
+- name: FUNCTION_NAME
+{{- if .Values.agent.function_name }}
+  value: {{ .Values.agent.function_name | quote }}
+{{- else }}
+  value: "MyAgentFunction"
+{{- end }}
+{{- end }}

ai-models/agents_deployment/helm/templates/job.yaml

@@ -28,6 +28,7 @@ spec:
           command: ["./function_registration.sh"]
           env:
             {{- include "agent.commonEnv" . | nindent 12 }}
+            {{- include "agent.functionNameEnv" . | nindent 12 }}
             {{- include "agent.modelParamsOverride" . | nindent 12 }}
             {{- range .Values.job.envVars }}
             - name: {{ .name }}

ai-models/agents_deployment/helm/values.yaml

@@ -8,6 +8,8 @@ image:
 
 agent:
   ### Common configuration
+  # Please specify a unique name for your agent's function. Uniqueness is username + function name.
+  function_name: "myfunction"
   # Please specify the number of agent replicas you want to deploy.
   replicaCount: 1
   # Please specify the organization slug in CVAT if you want to deploy agent under organization. Else leave empty.
@@ -35,12 +37,19 @@ agent:
       model_id:
         type: str
         value: "facebook/sam2.1-hiera-tiny"
+    transformers-detr:
+      model:
+        type: str
+        value: "facebook/detr-resnet-50"
+      task:
+        type: str
+        value: "object-detection"
     custom:
       # use modelParamsOverride to specify custom parameters for your model.
 
   # Please pick a preset for your agent's model configuration. The preset will automatically fill in the necessary parameters for the chosen model type. If you choose a preset, you can still override specific parameters in the `modelParamsOverride` section below.
   # Keys with empty 'value' will be ignored.
-  preset: sam2
+  preset: transformers-detr
   modelParamsOverride: { }
 #  modelParamsOverride:
 #      model:

ai-models/agents_deployment/transformers/.env

@@ -0,0 +1,44 @@
+# Docker compose
+CVAT_BASE_URL=your_cvat_url # Your CVAT instance URL. Default is https://app.cvat.ai
+CVAT_ACCESS_TOKEN=your_cvat_access_token_here # Required to authenticate to CVAT API. You can get it in CVAT UI: https://app.cvat.ai/profile#security
+FUNCTION_NAME=your_function_name # Name of the function to create in CVAT.
+IMAGE_URL= your_cvat_image_here # Image to use for the agent.
+AGENTS_COUNT=1  # Number of agents to create. Default is 1.
+ORG_SLUG=your_organization_slug_here # If you want to create agent for your organization.
+USE_CUDA=false # Set to true if you want to use GPU. Please ensure that you use right docker image.
+
+# Model config params for transformers
+#
+# All -p parameters are passed as **kwargs to the create() function in func.py,
+# which forwards them to transformers.pipeline(**kwargs).
+# Any argument accepted by transformers.pipeline() can be passed here.
+#
+# Required params:
+#   task    - pipeline task type. Supported values are:
+#             "object-detection", "image-classification", "image-segmentation"
+#   model   - Hugging Face model ID (the "foo/bar" string from <ModelClass>.from_pretrained("foo/bar")
+#             in the model's documentation page on https://huggingface.co/docs/transformers)
+#
+# Optional params:
+#   device  - device to run inference on, e.g. "cpu", "cuda", "cuda:0". Default is "cpu".
+#
+# How to find the right model ID:
+#   1. Pick a model class from the supported list (e.g. DetrForObjectDetection)
+#   2. Open its page in Hugging Face Transformers docs
+#   3. Scroll to the from_pretrained() example — the string argument is your model ID
+#      Example: model = DetrForObjectDetection.from_pretrained("facebook/detr-resnet-50")
+#               → model ID is "facebook/detr-resnet-50"
+#   4. Alternatively, search for the model class on https://huggingface.co/models
+#      and use the model's repo name as the model ID
+#
+# Examples:
+#   Object detection:
+#     MODEL_CONFIG_PARAMS="-p task=str:object-detection -p model=str:hustvl/yolos-tiny"
+#     MODEL_CONFIG_PARAMS="-p task=str:object-detection -p model=str:facebook/detr-resnet-50"
+#   Image classification:
+#     MODEL_CONFIG_PARAMS="-p task=str:image-classification -p model=str:microsoft/resnet-50"
+#     MODEL_CONFIG_PARAMS="-p task=str:image-classification -p model=str:google/vit-base-patch16-224"
+#   Image segmentation:
+#     MODEL_CONFIG_PARAMS="-p task=str:image-segmentation -p model=str:facebook/detr-resnet-50-panoptic"
+
+MODEL_CONFIG_PARAMS="-p task=str:object-detection -p model=str:facebook/detr-resnet-50"

ai-models/agents_deployment/transformers/Dockerfile

@@ -0,0 +1,36 @@
+FROM python:3.14-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    git \
+    jq \
+    && rm -rf /var/lib/apt/lists/*
+
+ARG USE_GPU=false
+ARG TARGETARCH
+ADD --chmod=+x https://dl.k8s.io/release/v1.34.0/bin/linux/${TARGETARCH}/kubectl /usr/local/bin/
+
+RUN groupadd --gid 1000 agent && \
+    useradd --uid 1000 --gid 1000 --create-home agent
+
+WORKDIR /app
+
+RUN mkdir /shared && chown agent:agent /shared && chown agent:agent /app
+
+COPY ai-models/detector/transformers/requirements.txt .
+
+RUN if [ "$USE_GPU" = "true" ] && [ "$TARGETARCH" = "amd64" ]; then \
+        echo "Building GPU image" && pip install --no-cache-dir cvat-cli -r requirements.txt; \
+    else \
+        echo "Building CPU only image" && pip install --no-cache-dir cvat-cli -r requirements.txt --extra-index-url=https://download.pytorch.org/whl/cpu; \
+    fi
+
+COPY ai-models/detector/transformers/ .
+COPY --chmod=755 ai-models/agents_deployment/transformers/function_registration.sh .
+COPY --chmod=755 ai-models/agents_deployment/transformers/function_deregistration.sh .
+COPY --chmod=755 ai-models/agents_deployment/transformers/check_env.sh .
+COPY --chmod=755 ai-models/agents_deployment/transformers/entrypoint.sh .
+
+USER agent
+
+ENTRYPOINT ["./entrypoint.sh"]

ai-models/agents_deployment/transformers/check_env.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+validate_access_token() {
+    if [ -z "$CVAT_ACCESS_TOKEN" ]; then
+        echo "Error: CVAT_ACCESS_TOKEN environment variable must be set."
+        exit 1
+    fi
+}
+
+resolve_base_url() {
+    if [ -z "$CVAT_BASE_URL" ]; then
+        echo "Warning: CVAT_BASE_URL environment variable is missing, using https://app.cvat.ai as default."
+        CVAT_BASE_URL="https://app.cvat.ai"
+    fi
+}
+
+resolve_org_slug() {
+    ORG_SLUG_ARGS=()
+    if [ -z "$ORG_SLUG" ]; then
+        echo "Warning: ORG_SLUG environment variable not found. Function will be registered only for your user."
+        echo "ORG_SLUG must be the short name of the organization; it is the name displayed under your username when you switch to the organization in the CVAT UI."
+        ORG_CURL_ARGS=(--data-urlencode "org=")
+    else
+        echo "Using organization: $ORG_SLUG"
+        ORG_SLUG_ARGS=(--organization "$ORG_SLUG")
+        ORG_CURL_ARGS=(--data-urlencode "org=$ORG_SLUG")
+    fi
+}
+
+resolve_cuda() {
+    if [ "$USE_CUDA" = "true" ]; then
+        echo "Using CUDA! Please ensure that you are using proper image with CUDA support"
+        USE_CUDA_ARGS=(-p device=str:cuda)
+    else
+        echo "Info: USE_CUDA environment variable not found. Model will run on CPU."
+    fi
+}
+
+resolve_model_params() {
+    if [ -z "$MODEL_CONFIG_PARAMS" ]; then
+        echo "Warning: MODEL_CONFIG_PARAMS environment variable not found. Default model will be used: facebook/detr-resnet-50"
+        MODEL_CONFIG_PARAMS="-p model=facebook/detr-resnet-50"
+        MODEL="-p task=str:object-detection -p model=str:facebook/detr-resnet-50"
+    elif result=$(echo "$MODEL_CONFIG_PARAMS" | grep -oP 'model=str:\K[^ ]+'); then
+        echo "Extracted MODEL from MODEL_CONFIG_PARAMS: $result"
+        MODEL="$result"
+    else
+        echo "Warning: MODEL_CONFIG_PARAMS environment variable is set but model param is malformed. Your config will be discarded. Default values will be used."
+        echo "MODEL_CONFIG_PARAMS should contain model in format -p model=str:your_model_name"
+        echo "Following params will be used for cvat-cli: -p task=str:object-detection -p model=str:facebook/detr-resnet-50"
+        MODEL_CONFIG_PARAMS="-p task=str:object-detection -p model=str:facebook/detr-resnet-50"
+        MODEL="facebook/detr-resnet-50"
+    fi
+}
+
+resolve_function_name() {
+    if [ -z "$FUNCTION_NAME" ]; then
+        echo "Warning: FUNCTION_NAME environment variable not found. Default is TRANSFORMERS"
+        FUNCTION_NAME="TRANSFORMERS"
+    else
+        echo "Using FUNCTION_NAME: $FUNCTION_NAME"
+    fi
+}
+
+common_env() {
+    validate_access_token
+    resolve_base_url
+    resolve_org_slug
+}