# ydb

> YDB Python SDK

- **URL**: https://www.freshcrate.ai/projects/ydb
- **Author**: Yandex LLC
- **Category**: Databases
- **Latest version**: `3.29.1` (2026-06-04)
- **License**: Apache 2.0
- **Source**: http://github.com/ydb-platform/ydb-python-sdk
- **Language**: Python
- **GitHub**: 94 stars, 70 forks
- **Registry**: pypi (`ydb`)
- **Tags**: `pypi`

## 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)

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.8 or higher
- `pip` version 9.0.1 or higher

If necessary, upgrade your version of `pip`:

```sh
$ python -m pip install --upgrade pip
```

If you cannot upgrade `pip` due to a system-owned installation, you can
run the example in a virtualenv:

```sh
$ python -m pip install virtualenv
$ virtualenv venv
$ source venv/bin/activate
$ python -m pip install --upgrade pip
```

Install YDB python sdk:

```sh
$ python -m pip install ydb
```

## Development

Instructions on `ydb-python-sdk` development are located in [BUILD.md](BUILD.md).

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `3.29.1` | 2026-06-04 | High | * Fix driver.wait hang  Full Changelog: [3.29.0...3.29.1](https://github.com/ydb-platform/ydb-python-sdk/compare/3.29.0...3.29.1) |
| `3.29.0` | 2026-05-08 | High | * Added OpenTelemetry tracing support via `ydb.opentelemetry.enable_tracing()`  Full Changelog: [3.28.4...3.29.0](https://github.com/ydb-platform/ydb-python-sdk/compare/3.28.4...3.29.0) |
| `3.28.4` | 2026-04-29 | High | * Fix iam module lazy loading  Full Changelog: [3.28.3...3.28.4](https://github.com/ydb-platform/ydb-python-sdk/compare/3.28.3...3.28.4) |
| `3.28.3` | 2026-04-24 | High | * Fix session invalidation scheme  Full Changelog: [3.28.2...3.28.3](https://github.com/ydb-platform/ydb-python-sdk/compare/3.28.2...3.28.3) |
| `3.28.2` | 2026-04-23 | High | * Invalidate session on cancelled / transport stream errors  Full Changelog: [3.28.1...3.28.2](https://github.com/ydb-platform/ydb-python-sdk/compare/3.28.1...3.28.2) |
| `3.28.0` | 2026-04-21 | Low | Imported from PyPI (3.28.0) |
| `3.27.0` | 2026-04-06 | Medium | * Topic Writer Backpressure * Update writer debug logs  Full Changelog: [3.26.10...3.27.0](https://github.com/ydb-platform/ydb-python-sdk/compare/3.26.10...3.27.0) |
| `3.26.10` | 2026-04-01 | Medium | * Fix asyncio.Cancelled error propagated to writer/reader * add nearest DC detection with TCP race  Full Changelog: [3.26.9...3.26.10](https://github.com/ydb-platform/ydb-python-sdk/compare/3.26.9...3.26.10) |
| `3.26.9` | 2026-04-01 | Medium | * Send writers messages as one batch  Full Changelog: [3.26.8...3.26.9](https://github.com/ydb-platform/ydb-python-sdk/compare/3.26.8...3.26.9) |
| `3.26.8` | 2026-03-26 | Medium | * Make "Sent message larger than max" error non retryable * Better observability for errors in token refresh  Full Changelog: [3.26.7...3.26.8](https://github.com/ydb-platform/ydb-python-sdk/compare/3.26.7...3.26.8) |

## Citation

- HTML: https://www.freshcrate.ai/projects/ydb
- Markdown: https://www.freshcrate.ai/projects/ydb.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/ydb/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._