Install Mysqldb With pip

Muhammad Maisam Abbas Oct 21, 2023
  1. Installing mysqlclient
  2. Installing Legacy Version MySQL-python
  3. Using mysql-connector-python
  4. Verifying the Installation
  5. Troubleshooting
  6. Conclusion
Install Mysqldb With pip

In this comprehensive guide, we will walk you through the process of installing mysqldb in Python using the pip package manager. We’ll cover various methods and provide additional resources to ensure a smooth installation process.

Installing mysqlclient

The most common way to install mysqldb is by using the mysqlclient package. Execute the following command in your terminal or command prompt:

bashCopy code
pip install mysqlclient

This command will download and install the latest version of mysqldb along with its dependencies. Ensure that you have pip and Python installed on your system before running this command.

Installing Legacy Version MySQL-python

If you need to work with the legacy version of mysqldb, you can install it using the following command:

bashCopy code
pip install MySQL-python

This will install the 1.2.x versions of mysqldb. Be aware that this is a legacy package, and it might not be compatible with the latest versions of Python.

Using mysql-connector-python

As an alternative, you can also use the mysql-connector-python package, which is a pure Python driver from MySQL. It can be installed with the following command:

bashCopy code
pip install mysql-connector-python

This package is maintained by MySQL, and it provides official support and documentation, making it a reliable choice for connecting to MySQL databases.

Verifying the Installation

After the installation is complete, you can verify it by importing the mysqldb module in Python. Open a Python shell and execute:

pythonCopy code
import MySQLdb

If there are no errors, the installation was successful. You can now proceed to use mysqldb to connect and interact with MySQL databases.


If you encounter any issues during the installation, ensure that:

  • Your Python and pip are correctly installed and updated to the latest versions.
  • You have the necessary build dependencies installed. On Debian-based systems, you can install them with:
bashCopy code
sudo apt-get install default-libmysqlclient-dev
  • If you are on Windows, consider using a precompiled binary package for mysqlclient, which can be found on unofficial Windows binaries for Python extension packages.


Installing mysqldb in Python is straightforward with the pip package manager. Choose the appropriate package based on your needs and system compatibility. Always ensure to test the installation and refer to official documentation for best practices and advanced configurations.

Muhammad Maisam Abbas avatar Muhammad Maisam Abbas avatar

Maisam is a highly skilled and motivated Data Scientist. He has over 4 years of experience with Python programming language. He loves solving complex problems and sharing his results on the internet.


Related Article - Python Installation