---
id: ydb
version: "3.31.2"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# ydb — YDB Python SDK

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install ydb
uv add ydb
poetry add ydb

## Description

YDB Python SDK
---
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/ydb-platform/ydb/blob/main/LICENSE)
[![PyPI version](https://badge.fury.io/py/ydb.svg)](https://badge.fury.io/py/ydb)
[![API Reference](https://img.shields.io/badge/API-Reference-lightgreen.svg)](https://ydb-platform.github.io/ydb-python-sdk)
[![Functional tests](https://github.com/ydb-platform/ydb-python-sdk/actions/workflows/tests.yaml/badge.svg)](https://github.com/ydb-platform/ydb-python-sdk/actions/workflows/tests.yaml)
[![Style checks](https://github.com/ydb-platform/ydb-python-sdk/actions/workflows/style.yaml/badge.svg)](https://github.com/ydb-platform/ydb-python-sdk/actions/workflows/style.yaml)
[![codecov](https://codecov.io/gh/ydb-platform/ydb-python-sdk/graph/badge.svg)](https://codecov.io/gh/ydb-platform/ydb-python-sdk)

Officially supported Python client for YDB.

---

**Documentation**: <a href="https://ydb-platform.github.io/ydb-python-sdk" target="_blank">https://ydb-platform.github.io/ydb-python-sdk</a>

---

## Quickstart

### Prerequisites

- Python 3.10 or higher
- `pip` version 9.0.1 or higher

If necessary, upgrade your version of `pip`:

```sh
$...

## AI interpretation — verify before relying

Official Python client for YDB, a distributed SQL database, enabling connection, querying, and transaction management through gRPC-based protocol bindings.

Verdict: Actively maintained official SDK with no security issues, permissive licensing, and low install friction. Suitable for production use with YDB databases; requires Python 3.10+ and a running YDB instance.

[View on SkillFed](https://skillfed.io/packages/ydb) · [View on PyPI](https://pypi.org/project/ydb/)