# About Connector/Python

{% hint style="info" %}

<p align="center">The most recent release of <a href="/spaces/CjGYMsT2MVP4nd3IyW2L/pages/JaiORpqoPj7lefpA0pqy">MariaDB Connector/Python</a> is:</p>

<h4 align="center"><a href="/spaces/aEnK0ZXmUbJzqQrTjFyb/pages/zISoeups32vbuVgJyH9V">Connector/Python 1.1.14</a> <a href="https://mariadb.com/downloads/connectors/connectors-data-access/python-connector" class="button primary">Download Now</a></h4>
{% endhint %}

MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249).

**Version 2.0** offers flexible distribution options:

* **Pure Python** - Works on all platforms, no compiler required
* **C extension** - Maximum performance (2-12× faster on data-heavy workloads)
* **Pre-compiled wheels** - No MariaDB Connector/C installation needed

All implementations support both synchronous and asynchronous operations.

{% hint style="info" %}
**Version 1.1 is the latest stable (GA) release; version 2.0 is currently a Release Candidate (RC).** Choose the version that fits your needs below. Do not use non-stable (non-GA) releases in production.
{% endhint %}

**Installation — version 1.1 (stable / GA):**

A plain `pip3 install` installs the latest stable release (1.1). It always installs the C extension and requires MariaDB Connector/C to be pre-installed; connection pooling is included by default.

```bash
# Latest stable release (1.1)
$ pip3 install mariadb

# Pin to a specific 1.1 release
$ pip3 install mariadb==1.1.14
```

**Installation — version 2.0 (Release Candidate):**

Version 2.0 is a pre-release, so the `--pre` flag is required — without it, pip installs the latest GA release (1.1).

```bash
# Pure Python (default)
$ pip3 install --pre mariadb

# C extension for maximum performance
$ pip3 install --pre mariadb[c]

# Pre-compiled binary wheels
$ pip3 install --pre mariadb[binary]

# With connection pooling
$ pip3 install --pre mariadb[binary,pool]
```

### Links:

* [Documentation](https://mariadb-corporation.github.io/mariadb-connector-python/index.html)
* [Bug tracker](https://jira.mariadb.org)
* Sources are hosted on [Github](https://github.com/mariadb-corporation/mariadb-connector-python)

<sub>*This page is*</sub> [<sub>*covered*</sub>](/docs/connectors/mariadb-connector-python/license.md) <sub>*by the*</sub> [<sub>*Creative Commons Attribution 3.0 license*</sub>](https://creativecommons.org/licenses/by/3.0/legalcode)<sub>*.*</sub>

{% @marketo/form formId="4316" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/connectors/mariadb-connector-python/mariadb-connector-python-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
