---
id: azure-cognitiveservices-vision-customvision
version: "3.1.1"
license: MIT License
license_treatment: permissive
maintenance: active
---

# azure-cognitiveservices-vision-customvision — Microsoft Azure Custom Vision Client Library for Python

License: permissive · Maintenance: active · Downloads: 108.2K/mo

## What it is and what it does

This is the official Python SDK for Microsoft Azure's Custom Vision service, allowing developers to programmatically train image classification and object detection models without writing machine learning code from scratch. The package wraps Azure's REST API, providing client classes for both training (building and managing models) and prediction (running inference on trained iterations). It depends on msrest, azure-common, azure-mgmt-core, and azure-cognitiveservices-vision-nspkg to handle authentication, HTTP communication, and Azure SDK conventions.

The package has been deprecated as of 11-01-2024 and will no longer receive maintenance or feature updates after that date. If you are starting a new project, Microsoft recommends migrating to a newer Azure Vision service SDK. Existing projects using this package will continue to work, but you should plan for eventual migration or accept that you will not receive updates beyond security patches.

Use it for:

- Train a custom image classifier to recognize specific product types in retail inventory photos.
- Build an object detection model to locate and count items in warehouse or manufacturing environments.
- Programmatically manage multiple Custom Vision projects and iterations without using the web portal.
- Export trained models for deployment to edge devices or containers as part of a CI/CD pipeline.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to train and deploy custom image classification and object detection models using Microsoft Azure's Custom Vision service.

No—do not install for new projects. The package is deprecated and will receive no maintenance after 11-01-2024. If you have an existing project already using this SDK, it will continue to work, but you should plan a migration to a current Azure Vision SDK. For new work, use a supported Azure SDK or alternative vision service.

## Install

pip install azure-cognitiveservices-vision-customvision
uv add azure-cognitiveservices-vision-customvision
poetry add azure-cognitiveservices-vision-customvision

## Installing azure-cognitiveservices-vision-customvision

Before you install: Low install friction with four stable Azure dependencies. However, the package is deprecated as of 11-01-2024 and will receive only security fixes—no new features or maintenance beyond that date.

License in practice: MIT License permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license text.

Quickstart:

pip install azure-cognitiveservices-vision-customvision

from azure.cognitiveservices.vision.customvision.training import CustomVisionTrainingClient
from msrest.authentication import ApiKeyCredentials

credentials = ApiKeyCredentials(in_headers={"Training-key": "your-key"})
client = CustomVisionTrainingClient(endpoint, credentials)

Requires a valid Azure Custom Vision endpoint URL and API key; credentials must be wrapped in msrest.authentication.ApiKeyCredentials, not passed as a plain string.

Verify before relying:

- Whether security fixes will continue to be released after 11-01-2024 or if the package will be completely frozen.
- Whether the deprecated status affects Azure's support for existing projects trained with this SDK.

## Package facts

- License: MIT License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 108.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure custom vision sdk, image classification training api, object detection azure, custom vision python client, azure cognitive services vision, deprecated, azure-sdk, computer-vision

[View on SkillFed](https://skillfed.io/packages/azure-cognitiveservices-vision-customvision) · [View on PyPI](https://pypi.org/project/azure-cognitiveservices-vision-customvision/)