Skip to main content

mysqlclient

This project is a fork of MySQLdb1. This project adds Python 3 support and fixed many bugs.

Support

Do Not use Github Issue Tracker to ask help. OSS Maintainer is not free tech support

When your question looks relating to Python rather than MySQL/MariaDB:

Or when you have question about MySQL/MariaDB:

Install

Windows

Building mysqlclient on Windows is very hard. But there are some binary wheels you can install easily.

If binary wheels do not exist for your version of Python, it may be possible to build from source, but if this does not work, do not come asking for support. To build from source, download the MariaDB C Connector and install it. It must be installed in the default location (usually "C:\Program Files\MariaDB\MariaDB Connector C" or "C:\Program Files (x86)\MariaDB\MariaDB Connector C" for 32-bit). If you build the connector yourself or install it in a different location, set the environment variable MYSQLCLIENT_CONNECTOR before installing. Once you have the connector installed and an appropriate version of Visual Studio for your version of Python:

$ pip install mysqlclient

macOS (Homebrew)

Install MySQL and mysqlclient:

$ # Assume you are activating Python 3 venv
$ brew install mysql pkg-config
$ pip install mysqlclient

If you don't want to install MySQL server, you can use mysql-client instead:

$ # Assume you are activating Python 3 venv
$ brew install mysql-client pkg-config
$ export PKG_CONFIG_PATH="$(brew --prefix)/opt/mysql-client/lib/pkgconfig"
$ pip install mysqlclient

Linux

Note that this is a basic step. I can not support complete step for build for all environment. If you can see some error, you should fix it by yourself, or ask for support in some user forum. Don't file a issue on the issue tracker.

You may need to install the Python 3 and MySQL development headers and libraries like so:

  • $ sudo apt-get install python3-dev default-libmysqlclient-dev build-essential pkg-config # Debian / Ubuntu
  • % sudo yum install python3-devel mysql-devel pkgconfig # Red Hat / CentOS

Then you can install mysqlclient via pip now:

$ pip install mysqlclient

Customize build (POSIX)

mysqlclient uses pkg-config --cflags --ldflags mysqlclient by default for finding compiler/linker flags.

You can use MYSQLCLIENT_CFLAGS and MYSQLCLIENT_LDFLAGS environment variables to customize compiler/linker options.

$ export MYSQLCLIENT_CFLAGS=`pkg-config mysqlclient --cflags`
$ export MYSQLCLIENT_LDFLAGS=`pkg-config mysqlclient --libs`
$ pip install mysqlclient

Documentation

Documentation is hosted on Read The Docs

Metadata

Release files for mysqlclient 2.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mysqlclient 2.2.5
File Size Uploaded
mysqlclient-2.2.5.tar.gz 90.5 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for mysqlclient 2.2.5
File
mysqlclient-2.2.5-pp310-pypy310_pp73-win_amd64.whl PyPy 3.10 PyPy 3.10 7.3 Windows x86-64 Details
mysqlclient-2.2.5-pp39-pypy39_pp73-win_amd64.whl PyPy 3.9 PyPy 3.9 7.3 Windows x86-64 Details
mysqlclient-2.2.5-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details
mysqlclient-2.2.5-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
mysqlclient-2.2.5-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
mysqlclient-2.2.5-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details
mysqlclient-2.2.5-cp39-cp39-win_amd64.whl CPython 3.9 CPython 3.9 Windows x86-64 Details

Total release size: 1.5 MB

Release files / mysqlclient-2.2.5.tar.gz

Download URL mysqlclient-2.2.5.tar.gz
Size 90.5 kB
Tags Source
SHA-256 checksum
How to use checksums
add8643c32f738014d252d2bdebb478623b04802e8396d5903905db36474d3ff
BLAKE2b-256 checksum
How to use checksums
be951af2ee813d4f0b607082c18bb82aa05c98a95a402a1d2d5808999317cb16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-pp310-pypy310_pp73-win_amd64.whl

Download URL mysqlclient-2.2.5-pp310-pypy310_pp73-win_amd64.whl
Size 207.3 kB
Tags PyPy 3.10 PyPy 3.10 7.3 Windows x86-64
SHA-256 checksum
How to use checksums
1d2e2ca0fe8405d8d6464edd01bf059951279e4bc27284d39341bd4737b2bc64
BLAKE2b-256 checksum
How to use checksums
be17cd1b80247f76968c1c5a643843c69c640a8548f4f5e131be6b10d4436def
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-pp39-pypy39_pp73-win_amd64.whl

Download URL mysqlclient-2.2.5-pp39-pypy39_pp73-win_amd64.whl
Size 207.3 kB
Tags PyPy 3.9 PyPy 3.9 7.3 Windows x86-64
SHA-256 checksum
How to use checksums
aee14f1872114865679fcb09aac3772de4595fa7dcf2f83a4c7afee15e508854
BLAKE2b-256 checksum
How to use checksums
215ac48769a4e4c500c27f8da3d1e375aca5313a1c5a94b08fc52c18b2943af5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-cp313-cp313-win_amd64.whl

Download URL mysqlclient-2.2.5-cp313-cp313-win_amd64.whl
Size 207.3 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
8012c633aab8c91ea8172ac479807135b171501b9cad1a7cd9b58c4dc8dcdab5
BLAKE2b-256 checksum
How to use checksums
62f94a43f9fde92eb463bdb08643c4a143751be2b68cd9ad0582d7ee80836ddc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-cp312-cp312-win_amd64.whl

Download URL mysqlclient-2.2.5-cp312-cp312-win_amd64.whl
Size 207.3 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
e871ede4261d0d42b8ed20a2459db411c7deafedd8e77b7e4ba760be4a6a752b
BLAKE2b-256 checksum
How to use checksums
8b96962f16047ed35ee8c91c10c26a98057194242f6c8da3b78238909a8014fe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-cp311-cp311-win_amd64.whl

Download URL mysqlclient-2.2.5-cp311-cp311-win_amd64.whl
Size 207.2 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
b54511648c1455b43ac28f8b4c1f732c5b0c343e87f7a3bd6fc9f9fe0f91934e
BLAKE2b-256 checksum
How to use checksums
9a120e10b29d0a880e0d2482fe93d502d537bddf647f1a35468c8b98bb517c91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-cp310-cp310-win_amd64.whl

Download URL mysqlclient-2.2.5-cp310-cp310-win_amd64.whl
Size 207.2 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
b78438314199504c64f69e1e3521f2c9b419f19fcd85158b44c997b64409a6af
BLAKE2b-256 checksum
How to use checksums
87785dc4d98b998e957968aa8ad807a6ca7f751ef79ce462da11156317d7ca08
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release files / mysqlclient-2.2.5-cp39-cp39-win_amd64.whl

Download URL mysqlclient-2.2.5-cp39-cp39-win_amd64.whl
Size 207.2 kB
Tags CPython 3.9 Windows x86-64
SHA-256 checksum
How to use checksums
3f9625bea2b9bcde0ace76b32708762d44597491092c819fd1bff5b4e27f709b
BLAKE2b-256 checksum
How to use checksums
dafc91fda245bb5ce2c4778103ddf80621440a570b985d2a20457c39b28a39db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.4.24

Release history Release notifications | RSS feed

2.3.0

17 release files

2.2.8

7 release files

2.2.7

8 release files

2.2.6

8 release files

This release

2.2.5 This release

8 release files

2.2.4

9 release files

2.2.3

9 release files

2.2.2

9 release files

2.2.1

9 release files

2.2.0

7 release files

2.1.1

7 release files

2.1.0

5 release files

2.0.3

5 release files

2.0.2

5 release files

2.0.1

4 release files

2.0.0

4 release files

1.4.6

4 release files

1.4.5

3 release files

1.4.4

3 release files

1.4.3

1 release file

1.4.2

1 release file

1.4.1

3 release files

1.4.0

3 release files

1.3.13

1 release file

1.3.10

5 release files

1.3.9

3 release files

1.3.8

1 release file

1.3.7

3 release files

1.3.6

5 release files

1.3.5

1 release file

1.3.4

5 release files

1.3.3

5 release files

1.3.2

1 release file

1.3.1

5 release files

1.3.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page