label-studio-sdk

What it is and what it does

label-studio-sdk is a Python client library that wraps the Label Studio API, allowing developers to create, manage, and interact with annotation projects, tasks, and labels programmatically. It ships with both a Python API (instantiate a LabelStudio client and call methods like projects.create, tasks.create, projects.import_tasks) and a command-line interface that mirrors the SDK's resource structure.

The package is actively maintained and recently released version 2.0.0 with breaking changes and expanded feature support. It depends on a substantial set of runtime libraries including httpx and requests for HTTP communication, pydantic for data validation, and data processing tools like pandas, numpy, and opencv-python-headless. The library requires Python 3.10 or later and is distributed as a pure Python wheel, making installation straightforward across Windows, macOS, and Linux.

Use it for:

• Automate bulk creation and import of annotation tasks into Label Studio projects from external data sources.
• Build a Python application that programmatically retrieves project statistics, task metadata, or annotation results.
• Integrate Label Studio workflows into data pipelines by using the CLI to manage projects and tasks without writing Python code.
• Validate label configurations and manage project settings programmatically before launching annotation campaigns.
• Sync annotation data between Label Studio and external systems via the SDK's API methods.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python client library and CLI for interacting with the Label Studio API, enabling programmatic access to projects, tasks, annotations, and other Label Studio resources.

Yes, if you need programmatic access to Label Studio. The package is actively maintained, has low install friction, and supports current Python versions. However, verify the license terms before use—the metadata does not declare a license, which is a gap you should resolve before integrating into production or proprietary systems.

Install

label-studio-sdk on PyPI

pip install label-studio-sdk

uv add label-studio-sdk

poetry add label-studio-sdk

Installing label-studio-sdk

Before you install

Low friction installation with a pure Python wheel. Active maintenance with a release 4 days old and recent commits. Depends on 24 runtime packages including httpx, requests, and pydantic for core functionality, plus data processing libraries like pandas, numpy, and opencv-python-headless.

License in practice

License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms in the repository before use, particularly if this will be incorporated into proprietary or commercially distributed software.

Quickstart

pip install label-studio-sdk

from label_studio_sdk import LabelStudio

client = LabelStudio(
    base_url='YOUR_LABEL_STUDIO_URL',
    api_key='YOUR_API_KEY'
)
project = client.projects.create(title='My Project', label_config='...')

Requires Python 3.10 or later (supports up to 3.15). Requires a running Label Studio instance and valid API credentials.

Verify before relying

• Whether the unclear license is documented in the repository and what its terms are.
• Whether all 24 runtime dependencies are truly required for basic SDK usage or if some are optional.
• Performance characteristics and rate-limiting behavior with large numbers of tasks or projects.

Package facts

Evidence: label_studio_sdk-2.1.1-py3-none-any.whl

Tags

More Python Modules packages