524

I am using Python version 2.5.4 and install MySQL version 5.0 and Django. Django is working fine with Python, but not MySQL. I am using it in Windows Vista.

5
  • 74
    pip install mysql-python or pip install mysqlclient
    – Cœur
    Feb 19, 2017 at 11:21
  • 17
    I had to install sudo apt-get install libmysqlclient-dev to make it work.
    – b00r00x0
    Jun 18, 2018 at 18:57
  • 1
    pip install mysqlclient worked on windows x64 10, You rock Cœur Dec 27, 2018 at 17:06
  • 18
    For Python3.6 sudo apt-get install libmysqlclient-dev and pip3 install mysqlclient worked for me
    – Umair Ayub
    Mar 3, 2019 at 9:37
  • 1
    My environment is based on windows so I ran pip install mysqlclient and it worked.
    – codingbruh
    Sep 29, 2022 at 16:45

33 Answers 33

744

You need to use one of the following commands. Which one depends on what OS and software you have and use.

  1. easy_install mysql-python (mix os)
  2. pip install mysql-python (mix os/ python 2)
  3. pip install mysqlclient (mix os/ python 3)
  4. apt-get install python-mysqldb (Linux Ubuntu, ...)
  5. cd /usr/ports/databases/py-MySQLdb && make install clean (FreeBSD)
  6. yum install MySQL-python (Linux Fedora, CentOS ...)

For Windows, see this answer: Install mysql-python (Windows)

11
  • 1
    I had to update my version of setuptools to match my updated version of python on Mac OS before I could get this to work. Dec 21, 2011 at 23:57
  • 4
    and how about install on virtualenv with python 3 on it? I used: pip install mysql-python only to get: ImportError: No module named ConfigParser Aug 27, 2013 at 10:48
  • 11
    In Python 3, ConfigParser has been renamed to configparser for PEP 8 compliance. It looks like the package you are installing does not support Python 3. MySQL-python does not currently support Python 3.
    – derevo
    Aug 28, 2013 at 7:51
  • 7
    I receive this error when using 1 or 2 in OSX Yosemite: EnvironmentError: mysql_config not found
    – Mona Jalal
    Jun 30, 2016 at 20:38
  • 3
    FYI - I am on ubuntu 18 and using python3.7. After doing "pip install mysqlclient", I needed to do "sudo apt-get install libmysqlclient-dev" for successful installation. Nov 19, 2019 at 9:09
176

...and remember there is no MySQLdb for python3.x

(I know the question is about python2.x but google rates this post quite high)


EDIT: As stated in the comments, there's a MySQLdb's fork that adds Python 3 support: github.com/PyMySQL/mysqlclient-python

6
  • Urghhgwaarrbl... there goes my hopes of using python3 in my Django app Feb 2, 2015 at 16:45
  • 7
    Luckily, there is a selection of alternatives, many of which use the same API: Python 3 and MySQL Mar 24, 2015 at 10:07
  • 4
    mysqlclient is a fork of MySQLdb that works well with Python 3.
    – ostrokach
    Feb 4, 2016 at 23:57
  • @JanekOlszak I did not know this - only took about a day of lots of cursing and banging on the keyboard - until reading this and swapping over to 2.7. And guess what, everything works hunky-dory~
    – 3kstc
    Aug 11, 2016 at 1:14
  • My journey, this -> this -> this. And then, I was finally able to successfully install it.
    – olfek
    Feb 23, 2019 at 15:00
98

if your python version is 3.5, do a pip install mysqlclient, other things didn't work for me

11
  • I don't know why this answer was down-voted, but mysqlclient is a fork of the MySQLdb project, and I can confirm this worked for me on Windows 10 Jul 20, 2016 at 8:54
  • 1
    Worked for me on arch linux
    – Luke Dupin
    Jan 7, 2017 at 18:43
  • Worked on Ubuntu 16.10, Python 3.5.2+
    – user63289
    Jul 16, 2017 at 13:51
  • Worked on Ubuntu 14.04 Python 3.4.3
    – gpk27
    Oct 23, 2017 at 6:32
  • Worked on macOS, Python 3.6.0 Oct 27, 2017 at 22:53
49

mysqldb is a module for Python that doesn't come pre-installed or with Django. You can download mysqldb here.

2
  • 1
    Trying to install MySQL-python-1.2.1 I get the message ImportError: No module named setuptools Trying to install setuptools, I get zlib not available isn't it supposed to be bundled with python ? May 2, 2011 at 9:30
  • after downloading the module you'll need to edit the site.cfg file with the right path for mysql_config and the run python setup.py install
    – ntanase
    Mar 8, 2014 at 23:44
37

Note this is not tested for python 3.x

In CMD

pip install wheel
pip install pymysql

in settings.py

import pymysql
pymysql.install_as_MySQLdb()

It worked with me

4
  • 3
    "pip3 install mysqlclient" solve the problem for python3.6/ Feb 11, 2017 at 7:49
  • I can't upvote this enough! The only solution that works on Databricks..
    – Foxan Ng
    Nov 22, 2018 at 9:09
  • 1
    This code pymysql.install_as_MySQLdb() save me. Thanks! Jun 18, 2022 at 0:36
  • 1
    Thanks! Worked for me. No need to install wheel. Mar 11 at 17:57
35

I am at ubuntu (linux) and what worked for me was

sudo apt-get install python3-dev default-libmysqlclient-dev build-essential

and then finally

pip install mysqlclient
0
35

For anyone coming to this page when trying to find a solution for sqlalchemy, all you need to do is:

pip install PyMySQL

And adjust your connection string to use PyMySQL, from mysql:// to mysql+pymysql://.

2
  • This also works on M1 Macs. The mysql-python client doesn't work (yet) as of Jan 31, 2021.
    – JasonD
    Feb 1, 2021 at 1:48
  • It worked on flask but where can I find the official link to this? Sep 3, 2021 at 13:28
34

Ubuntu:

sudo apt-get install python-mysqldb
0
23

for Windows :

pip install mysqlclient pymysql

then:

import pymysql
pymysql.install_as_MySQLdb()

for python 3 Ubuntu

sudo apt-get install -y python3-mysqldb
2
  • Running just "pip install mysqlclient pymysql" on Windows 10 (Python 3.6.2) resolved my issue. Jan 15, 2019 at 20:13
  • sudo apt-get install -y python3-mysqldb worked for me.
    – user14761470
    Aug 1, 2021 at 16:38
20
pip install PyMySQL

and then add this two lines to your Project/Project/init.py

import pymysql
pymysql.install_as_MySQLdb()

Works on WIN and python 3.3+

3
  • I used your suggestion successfully. Only change was in the import command: import pymysql There was at type.
    – Jorge
    Sep 10, 2017 at 16:41
  • worked for me on windows10, python 3.6, virtual environment
    – Yikang Luo
    Aug 17, 2018 at 16:46
  • 1
    Love this hack. Although I've managed to get it to work without it yet had to incorporate a whql binary.
    – Ishmael
    Oct 11, 2018 at 14:57
13

If pip install mysqlclient produces an error and you use Ubuntu, try:

sudo apt-get install -y python-dev libmysqlclient-dev && sudo pip install mysqlclient
1
  • this one worked for me on python 3.6.11 on ubuntu 18.04 on aws
    – Stevko
    Aug 3, 2020 at 20:34
13

Try this.

pip install MySQL-python
1
  • 2
    How does this apply specifically to virtual environments?
    – Tim
    Dec 30, 2016 at 17:32
12

For Python 3.6+

sudo apt-get install libmysqlclient-dev
pip3 install mysqlclient

does the trick

10

Python 3.8

sudo apt-get install libmysqlclient-dev
sudo apt-get install -y python3-mysqldb
pip3 install pymysql

settings.py

import pymysql
pymysql.install_as_MySQLdb()
7

I met the same situation under windows, and searched for the solution.

Seeing this post Install mysql-python (Windows).

It points out installing such a pip environment is difficult, needs many other dependencies.

But I finally know that if we use mysqlclient with a version down to 1.3.4, it don't need that requirements any more, so try:

pip install mysqlclient==1.3.4
6
pip install --user mysqlclient 

above works for me like charm for me.I go the error from sqlalchemy actually. Environment information :

Python : 3.6, Ubuntu : 16.04,conda 4.6.8

6

I personally recommend using pymysql instead of using the genuine MySQL connector, which provides you with a platform independent interface and could be installed through pip.

And you could edit the SQLAlchemy URL schema like this: mysql+pymysql://username:passwd@host/database

5

If you are running on Vista, you may want to check out the Bitnami Django stack. It is an all-in-one stack of Apache, Python, MySQL, etc. packaged with Bitrock crossplatform installers to make it really easy to get started. It runs on Windows, Mac and Linux. Oh, and is completely free :)

2
  • Then why did you say "If you are running on Vista" if it will work on more than Vista? That's misleading and confusing.
    – Anthony
    Dec 22, 2013 at 14:41
  • 3
    To Anthony: I just found funny that the top-voted comment provided instructions for Linux, FreeBSD and OSX but not for Vista as specified by the poster Dec 25, 2013 at 20:04
5
  • Go to your project directory with cd.
  • source/bin/activate (activate your env. if not previously).
  • Run the command easy_install MySQL-python
1
  • 2
    Doesn't work ModuleNotFoundError: No module named 'ConfigParser'
    – TomSawyer
    Mar 17, 2019 at 7:42
4

Thanks to derevo but I think there's another good way for doing this:

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install mysql-python
  4. Read the notes specific to this package.

I think pypm is more powerful and reliable than easy_install.

4
  • Seems like it requires a paid subscription Can't install mysql-python-1.2.3: requires Business Edition subscription
    – Jeremy S.
    Nov 21, 2012 at 13:17
  • I don't think so. I remember I've installed that with no problem. Nov 21, 2012 at 16:19
  • why do you think pypm is more powerful and reliable than easy_install? any points to support that? any articles / blogposts? Apr 29, 2013 at 10:25
  • 2
    I think this would be the article / blog post to support that :P I mean, come on, you support such a comment with typically technical arguments, not with someone else who claims the same, but also may not have arguments. However, arguments would be nice ;)
    – Herbert
    Dec 2, 2013 at 11:47
3

On OSX these commands worked for me

brew install mysql-connector-c 
pip install MySQL-python
3

For Python 3+ version

install mysql-connector as:

pip3 install mysql-connector 

Sample Python DB connection code:

import mysql.connector
db_connection = mysql.connector.connect(
  host="localhost",
  user="root",
  passwd=""
)
print(db_connection)

Output:

> <mysql.connector.connection.MySQLConnection object at > 0x000002338A4C6B00>

This means, database is correctly connected.

3
  • The original question states clearly the error message, which is "No module named MySQLdb". Your solution gives exactly the same error. Thus, your solution is wrong.
    – Xxxo
    Sep 23, 2021 at 10:30
  • It connects correctly and doesn't give error. Please check again.
    – Om Sao
    Sep 23, 2021 at 12:39
  • Please read what the original question is and what I wrote. I never mentioned about connection and the original question is not about connection. Is about ModuleNotFoundError.
    – Xxxo
    Sep 24, 2021 at 8:00
3

On Debian Buster, the following solution worked for me with python 3.7:

sudo apt-get install libmysqlclient-dev
sudo apt-get install libssl-dev
pip install mysqlclient
3

Python 3

Make sure the import order:

#BAD
import MySQLdb             # <------ NOT here
import pymysql
pymysql.install_as_MySQLdb()

#GOOD
import pymysql
pymysql.install_as_MySQLdb()
import MySQLdb              # <------- HERE!
2

I have tried methods above, but still no module named 'MySQLdb', finally, I succeed with

easy_install mysql-python

my env is unbuntu 14.04

1
  • success for virtualenv/python2.7
    – nguyên
    May 24, 2017 at 6:48
2

If your are using SQLAlchemy and the error is in /site-packages/sqlalchemy/dialects/mysql/mysqldb.py:

from ...connectors.mysqldb import (
                        MySQLDBExecutionContext,
                        MySQLDBCompiler,
                        MySQLDBIdentifierPreparer,
                        MySQLDBConnector
                    )

so you may have missed mysqldb connector for SQLAlchemy and the solution is to re-install sqlalchemy after installing mysql-python module.

2

None of the above worked for me on an Ubuntu 18.04 fresh install via docker image.

The following solved it for me:

apt-get install holland python3-mysqldb

1

On my mac running Catalina v10.15.2, I had the following MySQLdb version conflict:

ImportError: this is MySQLdb version (1, 2, 5, 'final', 1), but _mysql is version (1, 4, 6, 'final', 0)

To resolve it, I did the following:

pip uninstall MySQL-python
pip install MySQL-python
1

Faced this issue with mysql.connector.python version 8.0.24 on mac(if code base is same then the issue should happen in windows as well). This file on line 51 imports "from django.db.backends.mysql.base import DatabaseWrapper as MySQLDatabaseWrapper". The imported file has following code 14-20(exact code and error that you received is part of code

try:
    import MySQLdb as Database
except ImportError as err:
    raise ImproperlyConfigured(
        'Error loading MySQLdb module.\n'
        'Did you install mysqlclient?'
    ) from err

The error is formed here. Not sure why this import keeps coming back in different version of mysql connector but 8.0.23 does not have the import, so I reverted to that version and error was gone... This is incase you wish to continue to work with mysql.connector.python

1

Windows 7 / Python 3.6.5 this works for me:

conda install -y mysqlclient

Not the answer you're looking for? Browse other questions tagged or ask your own question.