> For the complete documentation index, see [llms.txt](https://docs.unitlab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unitlab.ai/release-notes/2026-python-sdk-releases.md).

# 2026 PYTHON SDK RELEASES

Unitlab Python SDK and CLI releases published through November 2026.

These package versions are independent from Unitlab Platform versions. Install the latest release from [PyPI](https://pypi.org/project/unitlab/) and follow the [Python SDK guide](https://docs.unitlab.ai/api-sdk-cli/get-started/python-sdk-quickstart).

{% updates format="full" %}
{% update date="2026-11-19" %}

## v3.2.0: Benchmark uploads and answer-key imports

**Features**

* Added benchmark creation during project uploads, including deferred marking for items that are still processing and retryable item lists when marking fails.
* Added annotation imports into hidden benchmark answer keys, with optional approval, Data Group support, and detailed benchmark results.

**Fixes**

* Prevented unsupported servers from silently importing benchmark labels into live item annotations.
  {% endupdate %}

{% update date="2026-10-28" %}

## v3.1.6: Dataset draft controls and clearer file identity

**Features**

* Added dataset draft removal for selected assets in Python and the CLI.
* Added followed-folder behavior, optional publishing of unpublished datasets during project attachment, and detailed skipped-file results.
* Exposed stored file names separately from uploaded display names across Assets, datasets, projects, and workflow tasks.

**Fixes**

* Prevented late Agent-stage annotation saves after a task has moved to another workflow stage.
  {% endupdate %}

{% update date="2026-10-22" %}

## v3.1.5: Safer downloads and faster dataset reads

**Fixes**

* Protected inline and downloaded release files with temporary partial files so interrupted writes cannot appear complete.
* Bounded concurrent download work for very large releases and increased dataset item page size to reduce repeated processing.
  {% endupdate %}

{% update date="2026-10-20" %}

## v3.1.4: Agent webhooks and workflow annotation access

**Features**

* Added signed Agent-stage webhook parsing for task-ready and connection-test events.
* Added workflow task annotation reads and saves for UUEF, GeoJSON, model replies, large documents, and native LiDAR results.
* Added Agent run completion and failure actions, including large-result handling and revision conflict protection for LiDAR saves.
  {% endupdate %}

{% update date="2026-10-16" %}

## v3.1.3: Annotation import size validation

**Fixes**

* Aligned local annotation-import validation with the 80 MiB service limit so oversized label files fail before upload.
  {% endupdate %}

{% update date="2026-10-16" %}

## v3.1.2: Completed-item releases

**Features**

* Added a `completed_only` release option for exporting items whose current workflow status is Complete.

**Fixes**

* Refused the request when a server does not support completed-only releases instead of returning a broader release silently.
  {% endupdate %}

{% update date="2026-10-15" %}

## v3.1.1: More reliable imports and uploads

**Fixes**

* Added readable timeout and connection errors, safer processing waits, adjustable upload concurrency, and clearer failed-file reporting.
* Extended annotation import timeouts, preserved idempotent retries, and exposed blocked rows and file issues through a dedicated import error.
  {% endupdate %}

{% update date="2026-10-15" %}

## v3.1.0: Annotation imports and proxy-aware connections

**Features**

* Added preview and commit workflows for COCO, UUEF, Audio JSON, GeoJSON, and native Unitlab annotation formats across supported project types.
* Added local and connected-storage import sources, conflict decisions, partial commits, stable IDs, and frame mappings.

**Fixes**

* Enabled standard HTTP, HTTPS, SOCKS, and no-proxy environment settings while preserving connection retries.
  {% endupdate %}

{% update date="2026-10-08" %}

## v3.0.5: LiDAR scenes and larger direct uploads

**Features**

* Added LiDAR scene detection, preview, upload, processing status, and retry support for single clouds, sensor folders, scene archives, and nuScenes datasets.
* Added direct-to-storage uploads for large video, medical, audio, and PDF files, plus extensionless DICOM detection.
* Added matching LiDAR and large-file workflows to Assets and the CLI.
  {% endupdate %}

{% update date="2026-09-24" %}

## v3.0.4: Asynchronous releases and consensus tools

**Features**

* Added background release creation with refresh, progress, wait, and CLI wait controls.
* Added consensus task details, comparison reads, and component-copy actions.
* Added model-run completion and failure actions for workflow tasks.

**Fixes**

* Renewed expiring multipart upload URLs during long tiled uploads and added clearer release conflict states.
  {% endupdate %}

{% update date="2026-08-28" %}

## v3.0.3: Structured data upload workflows

**Features**

* Added project and Assets uploads for HTML, time-series data, and tabular CSV files.
* Added deferred time-series configuration, row-mode column selection, ontology shapes, and unified processing status.
  {% endupdate %}

{% update date="2026-08-12" %}

## v3.0.2: Tiled geospatial and pathology uploads

**Features**

* Added large GeoTIFF and whole-slide image uploads to projects and Assets with processing status, wait, and retry support.

**Fixes**

* Aligned release download responses with the current service contract.
  {% endupdate %}

{% update date="2026-07-31" %}

## v3.0.1: Reliable release downloads

**Features**

* Added destination directories for annotation downloads and documented persistent Unitlab download links.

**Fixes**

* Added longer release timeouts and temporary partial files to prevent interrupted downloads from appearing complete.
  {% endupdate %}

{% update date="2026-07-27" %}

## v3.0.0: Resource-based SDK and expanded CLI

**Features**

* Introduced resource namespaces for projects, Assets, folders, cloud storage, Data Groups, datasets, embeddings, ontologies, workflows, releases, uploads, and attached sources.
* Added typed public results, ontology builders, workflow task actions, Batch Queue waits, and machine-readable CLI output.
* Added one Python package and console interface for current Unitlab automation, requiring Python 3.10 or newer.

**Fixes**

* Added clearer authentication, validation, permission, subscription, timeout, and processing errors for production automation.
  {% endupdate %}

{% update date="2026-07-10" %}

## v2.5.1: Consistent direct-upload sessions

**Fixes**

* Applied one upload session across every file in a project upload, including medical finalization, to keep direct-upload assets grouped correctly.
  {% endupdate %}

{% update date="2026-06-18" %}

## v2.5.0: Release-based dataset downloads

**Fixes**

* Updated dataset listing and download commands to use release endpoints and removed unsupported project-member and text-chunk options.
  {% endupdate %}

{% update date="2026-05-22" %}

## v2.4.6: Mixed uploads and complete download results

**Features**

* Added mixed-directory uploads across images, text, video, audio, medical files, and PDFs, with recursive discovery and type-specific limits.
* Added all-split annotation downloads and upload result counts in Python and the CLI.

**Fixes**

* Reported partial upload and download failures instead of silently completing with missing files.
  {% endupdate %}

{% update date="2026-04-23" %}

## v2.4.5: Simpler dataset downloads

**Fixes**

* Simplified split handling and improved errors when dataset annotation downloads cannot be prepared.
  {% endupdate %}

{% update date="2026-04-13" %}

## v2.4.4: Automatic dataset split selection

**Features**

* Added automatic split detection when downloading dataset annotations without an explicit split.
  {% endupdate %}

{% update date="2026-04-01" %}

## v2.4.3: Medical upload sessions

**Features**

* Added session-based medical project uploads with finalization after the selected files complete.
  {% endupdate %}

{% update date="2026-03-27" %}

## v2.4.2: Unified HTTP transport and clearer API errors

**Fixes**

* Unified synchronous and asynchronous requests on `httpx`, added readable service error messages, and corrected validation split values.
* Improved timeout handling and reliability for uploads and dataset downloads while reducing runtime dependencies.
  {% endupdate %}

{% update date="2026-02-18" %}

## v2.4.1: PyPI documentation assets

**Fixes**

* Corrected package documentation image URLs so the Python package page renders its setup guidance reliably.
  {% endupdate %}

{% update date="2026-02-18" %}

## v2.4.0: Refreshed Python client and CLI

**Features**

* Added a Python 3.10+ client and CLI for project discovery, uploads, dataset downloads, API-key configuration, and custom service URLs.

**Fixes**

* Added safe download paths and clearer authentication, not-found, subscription, network, and timeout errors.
  {% endupdate %}

{% update date="2026-02-13" %}

## v2.3.48: Video upload controls and nested dataset files

**Features**

* Added configurable frame rate for video project uploads in Python and the CLI.

**Fixes**

* Preserved nested paths and inline content when downloading dataset files and returned the completed local destination.
  {% endupdate %}
  {% endupdates %}

***

> **Continue with the SDK:** [Install the Python SDK and CLI](https://docs.unitlab.ai/api-sdk-cli/get-started/install-the-python-sdk-and-cli) · [Python SDK quickstart](https://docs.unitlab.ai/api-sdk-cli/get-started/python-sdk-quickstart)
