# Python SDK

The SurrealDB SDK for Python enables simple and advanced querying of a remote or embedded database.

The SurrealDB SDK for Python lets you connect to SurrealDB from any Python application. It supports both synchronous and asynchronous workflows, connecting to remote instances over WebSocket or HTTP, and running embedded databases in-process. The SDK provides methods for querying, managing data and authentication, and subscribing to real-time updates with live queries.

> [!IMPORTANT]
> The SDK requires Python `3.10` or later, and is available as a [PyPI package](https://pypi.org/project/surrealdb/).

> [!NOTE]
> The latest version of the SDK is `2.0.0`.
> The SDK works with SurrealDB versions `v2.0.0` and later, including the current release, `v3.2.4`.

## Getting started

- [Installation](/docs/reference/python/installation.md) - Install the SDK and add it to your project.

- [Getting started guide](/docs/languages/python.md) - Connect to SurrealDB and run your first queries.

## Learn

- [Concepts](/docs/reference/python/concepts/connecting-to-surrealdb.md) - Guides for connecting, authenticating, querying, and working with data.

- [API Reference](/docs/reference/python/api/core/surreal.md) - Complete reference for the SDK's methods, types, and errors.

## Contributing

To contribute to the SDK code, submit an Issue or Pull Request in the [surrealdb.py](https://github.com/surrealdb/surrealdb.py) repository. To contribute to this documentation, submit an Issue or Pull Request in the [docs.surrealdb.com](https://github.com/surrealdb/docs.surrealdb.com) repository.

## Sources

- [GitHub repository](https://github.com/surrealdb/surrealdb.py)
- [PyPI package](https://pypi.org/project/surrealdb/)