442

I am trying to plot a simple graph using pyplot, e.g.:

import matplotlib.pyplot as plt
plt.plot([1,2,3],[5,7,4])
plt.show()

but the figure does not appear and I get the following message:

UserWarning: Matplotlib is currently using agg, which is a non-GUI backend, so cannot show the figure.

I saw in several places that one had to change the configuration of matplotlib using the following:

import matplotlib
matplotlib.use('TkAgg')
import matplotlib.pyplot as plt

I did this, but then got an error message because it cannot find a module:

ModuleNotFoundError: No module named 'tkinter'

Then, I tried to install "tkinter" using pip install tkinter (inside the virtual environment), but it does not find it:

Collecting tkinter
  Could not find a version that satisfies the requirement tkinter (from versions: )
No matching distribution found for tkinter

I should also mention that I am running all this on Pycharm Community Edition IDE using a virtual environment, and that my operating system is Linux/Ubuntu 18.04.

I would like to know how I can solve this problem in order to be able to display the graph.

10
  • 17
    Forget about the graph for a moment. Your problem is to install tkinter. Did you try any of the available solutions to that, e.g. stackoverflow.com/questions/4783810/install-tkinter-for-python ? Jun 18, 2019 at 20:47
  • 4
    Are you actually using tkinter for anything, or did you just pick it as a plt backend? Jun 18, 2019 at 20:53
  • 1
    @ImportanceOfBeingErnest: Thank you for the hint. I will indeed focus on installing tkinter first. I will have a look at the link you provided and see if I can make anything out of it. Jun 19, 2019 at 20:17
  • 1
    @G.Anderson: I had no idea what tkinter was before I ran into this error with matplotlib. Now I am trying to install it just to be able to show graphs (so yes, I guess I just picked it as a plt backend). If you know of any other way (i.e. without using tkinter), I would be glad to hear it. Jun 19, 2019 at 20:19
  • 2
    @G.Anderson: I ran the script to cycle through the different backends. It turns out that only TkAgg Is Available ! Indeed, I had just installed it prior to testing the script. Jun 19, 2019 at 20:41

35 Answers 35

525

Solution 1: is to install the GUI backend tk

I found a solution to my problem (thanks to the help of ImportanceOfBeingErnest).

All I had to do was to install tkinter through the Linux bash terminal using the following command:

sudo apt-get install python3-tk

instead of installing it with pip or directly in the virtual environment in Pycharm.

Solution 2: install any of the matplotlib supported GUI backends

  • solution 1 works fine because you get a GUI backend... in this case the TkAgg
  • however you can also fix the issue by installing any of the matplolib GUI backends like Qt5Agg, GTKAgg, Qt4Agg, etc
    • for example pip install pyqt5 will fix the issue also

NOTE:

  • usually this error appears when you pip install matplotlib and you are trying to display a plot in a GUI window and you do not have a python module for GUI display.
  • The authors of matplotlib made the pypi software deps not depend on any GUI backend because some people need matplotlib without any GUI backend.
12
  • 21
    Actually, I also realised that since I installed tkinter, I don't need to add the first two lines of my code anymore (import matplotlib and matplotlib.use('TkAgg')) Jun 19, 2019 at 21:03
  • 3
    For completeness, under OpenSuse Leap the package I had to install is called python3-matplotlib-tk.
    – Eldrad
    Jul 15, 2020 at 18:54
  • 18
    This answer could probably mention that tkinter is python version-specific in the sense that this particular command will install tkinter exclusively for your default version of python. Suppose you have different python versions installations for various virtual envs. In that case, you will have to install it for the desired python version used in that working venv. For example, in my case: sudo apt-get install python3.7-tk. Not knowing this made me struggle a reasonable amount of time getting no module name ' tkinter' errors, even after installing it for my global python version.
    – xicocaio
    Aug 5, 2020 at 20:41
  • I had to install a Linux Bash Terminal on my PC in order to run this command. And it worked! See howtogeek.com/249966/…
    – arame3333
    Oct 27, 2020 at 15:07
  • 7
    Or use sudo apt-get install python3.8-tk if your python version is 3.8
    – Vicrobot
    Jan 3, 2021 at 15:41
123

In my case, the error message was implying that I was working in a headless console. So plt.show() could not work. What worked was calling plt.savefig:

import matplotlib.pyplot as plt

plt.plot([1, 2, 3], [5, 7, 4])
plt.savefig("mygraph.png")

I found the answer on a github repository.

1
  • It doesn't really solve the underlying problem, but in my case this is the preferred solution in that it is better to save the image rather than show it, and this will often be the case.
    – arame3333
    Mar 13, 2021 at 19:11
54

If you use Arch Linux (distributions like Manjaro or Antegros) simply type:

sudo pacman -S tk

And all will work perfectly!

1
  • 2
    I'm afraid to say this is like the 3rd time I end up here. Perhaps by commenting on it, I stand a better chance of remembering the "trick" next time I try this again... Dec 15, 2021 at 22:16
44

Simple install

pip3 install PyQt5==5.9.2

It works for me.

5
  • Yup, it works! I installed it inside my virtual env via PyCharm's terminal.
    – WhaSukGO
    Aug 24, 2020 at 5:51
  • 16
    I execute "pip3 install PyQt5" without specifying version number.
    – oraclesoon
    Aug 26, 2020 at 18:23
  • This is the only answer solved my problem Mar 23, 2021 at 0:36
  • Dont know how this is not approved. Only this method worked May 22, 2021 at 2:28
  • I do not have tk installed and use latest and greatest (3.11.1) via pyenv. This worked
    – MortenB
    Jan 4 at 10:04
35

Try import tkinter because pycharm already installed tkinter for you, I looked Install tkinter for Python

You can maybe try:

import tkinter
import matplotlib
import matplotlib.pyplot as plt
matplotlib.use('TkAgg')
plt.plot([1,2,3],[5,7,4])
plt.show()

as a tkinter-installing way

I've tried your way, it seems no error to run at my computer, it successfully shows the figure. maybe because pycharm have tkinter as a system package, so u don't need to install it. But if u can't find tkinter inside, you can go to Tkdocs to see the way of installing tkinter, as it mentions, tkinter is a core package for python.

3
  • 3
    Thank you for your suggestion. Unfortunately, it does not work (ModuleNotFoundError: No module named 'tkinter'). I will try to install tkinter some other way. Jun 19, 2019 at 20:15
  • I also encountered the same problem...I'm using linux so I have used this command to install the tkinter sudo apt-get install python3-tk
    – Senthuran
    Mar 20, 2021 at 11:42
  • I have this issue which previously doesn't happen to me. I am using VS-code studio on Mac. Jun 10, 2022 at 13:55
23

The answer has been given a few times but it is not obvious, one needs to install graphics, this works.

pip3 install PyQt5
4
  • This worked when running a python binary via Bazel. +1 Aug 9, 2021 at 18:56
  • This works even when using terminal.
    – arilwan
    Oct 25, 2022 at 14:20
  • Try PyQt6 if PyQt5 gives the error qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
    – David
    Oct 27, 2022 at 9:42
  • QObject::moveToThread: Current thread (0x7239a60) is not the object's thread (0x73fa6a0). Cannot move to target thread (0x7239a60) qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "/home/titusfx/Projects/IA/football-roboflow/env/lib/python3.8/site-packages/cv2/qt/plugins" even though it was found. This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem. Available platform plugins are: xcb, eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, ...
    – titusfx
    Dec 9, 2022 at 12:18
23

I added %matplotlib inline and my plot showed up in Jupyter Notebook.

1
  • 1
    This one finally worked for me after trying out everything else (installing tk, pyqt5, .use('tkagg'), manual imports, etc.). I use VSCode on Windows.
    – m_h
    Sep 20, 2022 at 7:51
17

I too had this issue in PyCharm. This issue is because you don't have tkinter module in your machine.

To install follow the steps given below (select your appropriate os)

For ubuntu users

 sudo apt-get install python-tk

or

 sudo apt-get install python3-tk

For Centos users

 sudo yum install python-tkinter

or

 sudo yum install python3-tkinter

for Arch Users

  sudo pacman -S tk

or

  sudo pamac install tk

For Windows, use pip to install tk

After installing tkinter restart your Pycharm and run your code, it will work

13

This worked with R reticulate. Found it here.

1: matplotlib.use( 'tkagg' ) or 2: matplotlib$use( 'tkagg' )

For example:

import numpy as np
import matplotlib.pyplot as plt
from matplotlib import style

import matplotlib
matplotlib.use( 'tkagg' )


style.use("ggplot")
from sklearn import svm

x = [1, 5, 1.5, 8, 1, 9]
y = [2, 8, 1.8, 8, 0.6, 11]

plt.scatter(x,y)
plt.show()
6

If using Jupyter notebook try the following:

%matplotlib inline

This should render the plot even if not specifying the

plt.show()

command.

6

None of these answers worked for me using Pycharm Professional edition 2021.3

Regular matplotlib graphs did work on the scientific view, but it did not allow me to add images to the plots.

What did work for me is adding this line before I try plotting anything:

plt.switch_backend('TkAgg')

5

issue = “UserWarning: Matplotlib is currently using agg, which is a non-GUI backend, so cannot show the figure.”

And this worked for me

import matplotlib
import matplotlib.pyplot as plt
matplotlib.use('Qt5Agg')
2
  • Worked for me on Ubuntu 16.04, PyCharm Prof
    – alexkaz
    Apr 9, 2021 at 14:57
  • 1
    I think this is actually the right solution, because it is the easiest. Only need to install it where needed, e.g. by running : pip3 install PyQt5
    – Gregor
    Nov 25, 2021 at 14:31
4

For Windows 10, if using pip install tk does not work for you, try:

  • Download and run official python installer for windows. Even if you already have it downloaded, run it again.
  • When (re)installing python, make sure you chose "advanced" options, and set the checkbox "tcl/tk and IDLE" to true.
  • If you already had python installed, select the "Modify" option, and make sure that checkbox is selected.

Source of my fix: https://stackoverflow.com/a/59970646/2506354

1
  • This was exactly the problem I had. Re-downloading the python installer for windows and adding this to the python installation via modify (after it had upgraded). No re-creation of virtualenvs was required.
    – Aesir
    Dec 21, 2021 at 9:52
4

I have solved it by putting matplotlib.use('TkAgg') after all import statements. I use python 3.8.5 VSCODE and anaconda. No other tricks worked.

4

I installed python3-tk , on Ubuntu 20.04 and using WSL2

    import numpy as np
    import matplotlib.pyplot as plt
    import matplotlib
    matplotlib.use( 'tkagg')

and then I installed GWSL from the Windows Store which seems to solve problem of WSL2 rendering out of the box

3

This will solve the issue. It works well in jupyter.

%matplotlib inline
1
  • 2
    This is already mentioned in this answer and this answer. There is no need to be repeating existing answers. Once you have enough reputation, you can vote them up instead. Oct 29, 2021 at 3:25
2

The comment by @xicocaio should be highlighted.

tkinter is python version-specific in the sense that sudo apt-get install python3-tk will install tkinter exclusively for your default version of python. Suppose you have different python versions within various virtual environments, you will have to install tkinter for the desired python version used in that virtual environment. For example, sudo apt-get install python3.7-tk. Not doing this will still lead to No module named ' tkinter' errors, even after installing it for the global python version.

2

On Mac OS, I made it work with:

import matplotlib
matplotlib.use('MacOSX')
2

Ubuntu 20.04 command line setup. I install the following to make Matplotlib stop throwing the error UserWarning: Matplotlib is currently using agg, which is a non-GUI backend, so cannot show the figure.

I installed python-tk through the steps:

apt-get update

apt-get install python3.8-tk
1

Just in case if this helps anybody.

Python version: 3.7.7 platform: Ubuntu 18.04.4 LTS

This came with default python version 3.6.9, however I had installed my own 3.7.7 version python on it (installed building it from source)

tkinter was not working even when the help('module') shows tkinter in the list.

The following steps worked for me:

  1. sudo apt-get install tk-dev.

rebuild the python: 1. Navigate to your python folder and run the checks:

cd Python-3.7.7
sudo ./configure --enable-optimizations
  1. Build using make command: sudo make -j 8 --- here 8 are the number of processors, check yours using nproc command.
  2. Installing using:

    sudo make altinstall
    

Don't use sudo make install, it will overwrite default 3.6.9 version, which might be messy later.

  1. Check tkinter now
    python3.7 -m tkinter
    

A windows box will pop up, your tkinter is ready now.

1

After upgrading lots of packages (Spyder 3 to 4, Keras and Tensorflow and lots of their dependencies), I had the same problem today! I cannot figure out what happened; but the (conda-based) virtual environment that kept using Spyder 3 did not have the problem. Although installing tkinter or changing the backend, via matplotlib.use('TkAgg) as shown above, or this nice post on how to change the backend, might well resolve the problem, I don't see these as rigid solutions. For me, uninstalling matplotlib and reinstalling it was magic and the problem was solved.

pip uninstall matplotlib

... then, install

pip install matplotlib

From all the above, this could be a package management problem, and BTW, I use both conda and pip, whenever feasible.

1

You can change the matplotlib using backend using the from agg to Tkinter TKAgg using command

matplotlib.use('TKAgg',warn=False, force=True)
1
  • This was very helpful due to the fact that I didn't have to reload my interactive ipython console lol. Thanks May 24, 2020 at 5:01
1

Works if you use some third party code in your project. It probably contains the following line

matplotlib.use('Agg')

Search for it and comment it out.

If you have no clue about what it is you are probably not using this part of the code.

Solutions about using another backend GUI may be cleaner, so choose your fighter.

1

The solution that worked for me:

  1. Install tkinter

  2. import tkinter into the module

  3. make sure that matplotlib uses (TkAgg) instead of (Agg)

    matplotlib.use('TkAgg')

1

execute the following command before plotting

%matplotlib inline
1
  • Your answer could be improved with additional supporting information. Please edit to add further details, such as citations or documentation, so that others can confirm that your answer is correct. You can find more information on how to write good answers in the help center.
    – Community Bot
    Sep 15, 2021 at 12:01
1

Try:

%matplotlib inline

I had the same problem and it worked for me. I tested it on my Jupyter notebooks and visual studio code, so you should have no problems.

1

On WSL with X server

Make sure that your X server work. Matplotlib indicate this error if he can't connect to the X display.

Windows Firewall configuration

Pay attention to the windows firewall ! I changed from WSL Debian to Ubuntu and didn't remember about the firewall rule. I use this post to configure the windows firewall rule to make the X server work. This method avoid too permisive rule that able anyone to use your X server.

It said :

If you already had installed an X11 server, Windows may have created firewall rules that will mess with the above configuration. Search for them and delete them in "Windows Defender Firewall with Advanced Security."

You will now need to configure Windows Firewall to permit connections from WSL2 to the X11 display server. You will install the display server in the next step. We do this step first to avoid Windows Firewall from auto-creating an insecure firewall rule when you run the X11 display server. Many guides on X11 forwarding and WSL2 make this firewall rule too permissive, allowing connections from any computer to your computer. This means someone could theoretically, if they are on your same network, start sending graphical display information to your computer.

To avoid this, we will make Windows Firewall only accept internet traffic from the WSL2 instance.

To set this up, you can copy the below to a script and run it from within WSL2:

#!/bin/sh
LINUX_IP=$(ip addr | awk '/inet / && !/127.0.0.1/ {split($2,a,"/"); print a[1]}')
WINDOWS_IP=$(ip route | awk '/^default/ {print $3}')
# Elevate to administrator status then run netsh to add firewall rule
powershell.exe -Command "Start-Process netsh.exe -ArgumentList \"advfirewall firewall add rule name=X11-Forwarding dir=in action=allow program=%ProgramFiles%\VcXsrv\vcxsrv.exe localip=$WINDOWS_IP remoteip=$LINUX_IP localport=6000 protocol=tcp\" -Verb RunAs"

Manual method :

Alternatively, you can manually add the rule through a GUI by doing the following:

  1. Open "Windows Defender Firewall with Advanced Security"
  2. Click add new rule brings up the New Rule Wizard (next to navigate between each section):
    • Rule type: Custom
    • Program: "This program path:" %ProgramFiles%\VcXsrv\vcxsrv.exe
    • Protocol and ports
    • Protocol type: TCP
    • Local port: 6000
    • Remote port: any
    • Scope
      • Local IP address: Obtain the IP address to put in by running the below command in WSL2 ip route | awk '/^default/ {print $3}'
    • remote IP addresses
      • Obtain IP address to enter by running the below in WSL2 ip addr | awk '/inet / && !/127.0.0.1/ {split($2,a,"/"); print a[1]}'
    • Action: "Allow the connection
    • Profile: Selection Domain, Private, and Public
    • Name: "X11 forwarding"
1
  • While this link may answer the question, it is better to include the essential parts of the answer here and provide the link for reference. Link-only answers can become invalid if the linked page changes. - From Review Feb 17, 2022 at 2:55
0

Linux Mint 19. Helped for me:

sudo apt install tk-dev

P.S. Recompile python interpreter after package install.

0

When I ran into this error on Spyder, I changed from running my code line by line to highlighting my block of plotting code and running that all at once. Voila, the image appeared.

0

If you install python versions using pyenv on Debian-based systems, be sure to run sudo apt install tk-dev before pyenv install. If it's already installed, remove it with pyenv uninstall and install it again after install tk-dev. Therefore, there is no need to set any env variables when running pyenv install.

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