azure-cosmos

Microsoft Azure Cosmos Client Library for Python

azure-cosmos Permissive license MIT License Active ★ 5,587 v4.16.3 released 2026-07-29

Install

azure-cosmos on PyPI

pip

pip install azure-cosmos

uv

uv add azure-cosmos

poetry

poetry add azure-cosmos

Package facts

License	MIT License (permissive)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	2 — azure-core, typing-extensions
Maintenance	actively maintained — 15 days since the last release
Last repo commit	2026-08-13
First released	2018-09-21
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: azure_cosmos-4.16.3-py3-none-any.whl

Keywords: azure, azure sdk

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9

About azure-cosmos

from the package's own PyPI description — quoted content, verbatim

Azure Cosmos DB SQL API client library for Python

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Azure Cosmos DB is a globally distributed, multi-model database service that supports document, key-value, wide-column, and graph databases.

Use the Azure Cosmos DB SQL API SDK for Python to manage databases and the JSON documents they contain in this NoSQL database service. High level capabilities are:

Create Cosmos DB databases and modify their settings
Create and modify containers to store collections of JSON documents
Create, read, update, and delete the items (JSON documents) in your containers
Query the documents in your database using SQL-like syntax

> This SDK is used for the [SQL...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Python client library for Azure Cosmos DB SQL API, enabling creation and management of databases, containers, and JSON documents with SQL-like query support in a globally distributed NoSQL service.

Low friction installation with only two runtime dependencies (azure-core, typing-extensions). Active maintenance with a release 15 days ago and ongoing commits; production-stable status and top-1000 PyPI tier indicate reliable support.

MIT License permits commercial and private use with minimal restrictions, requiring only license and copyright notice retention in distributions.

Usage

pip install azure-cosmos

from azure.cosmos import CosmosClient
import os

URL = os.environ['ACCOUNT_URI']
KEY = os.environ['ACCOUNT_KEY']
client = CosmosClient(URL, credential=KEY)

Requires Python 3.9+; Azure Cosmos DB account with SQL API and valid ACCOUNT_URI and ACCOUNT_KEY environment variables.

Verdict: Well-maintained, production-grade SDK with minimal dependencies and no known vulnerabilities. MIT licensing and active development (release within 15 days) make it a solid choice for Python applications integrating with Azure Cosmos DB SQL API. Requires Python 3.9+ and valid Azure credentials.

Needs verification

Performance characteristics and throughput limits under typical workloads compared to direct REST API calls.
Whether connection pooling and retry logic are automatically configured or require explicit tuning for production scale.

azure cosmos db python clientnosql database sdk pythonjson document management azurecosmos db sql api pythonazure cloud database pythondistributed database client librarydocument store python sdk