Skip to content


Rikardo-new edited this page May 28, 2020 · 11 revisions

For classroom use see alternative deployment options.

Installing Thonny and Python bundle

Thonny bundles are supported on Windows 7, 8 and 10. If you need Thonny on Vista or XP, then see below how to install Thonny and Python separately.

By default the Windows installer doesn't request admin privileges to run (but see the section on SmartScreen Filter). This way students can install it on their lab computers at school without bugging the administrator. Without admin privileges it's not possible to install it under Program Files. That's why the installer proposes a folder under the current user's home folder. (BTW, Microsoft now recommends per user installs. Look for "The recommended default installation context is per-user" in*

If you want to install it for all users (under Program Files), then right-click on the installer executable and select "Run as Administrator".

Windows 8, 10 and SmartScreen Filter

Windows 8 and 10 include a feature called SmartScreen Filter, which tries to reduce the risk of users installing malware into their computers. See for more info.

The short story is that currently Windows 8 and 10 may be suspicious about the Thonny installer and may call it "unsafe".

The warnings are strongest when the installer is downloaded and run via Internet Explorer or Edge (if downloaded and run with e.g. Firefox, you should see the usual confirmation you're accustomed to seeing in previous Windows versions).

Actually, it's hard to predict exactly what kind of warnings SmartScreen will give you, because

How to work around the SmartScreen Filter?

  • Option 1: If you run the Thonny installer from Internet Explorer or Edge and see the warning "SmartScreen Filter reported Thonny-3.0.8.exe as unsafe", then click the button "View downloads", right-click on the Thonny installer and select "Run anyway".
  • Option 2: Just download the installer, open your Downloads folder in Windows Explorer and run the installer from there. Most likely you will see the usual confirmation titled "Do you want to run this file?". Just click "Run" and the installer will start.
  • Option 3: If you got a warning with no option to confirm your intention, or were asked to provide the admin password when you don't have one, then close the warning, right-click the installer, select "Properties" and check "Unblock" at the bottom of the "General" tab. After clicking "OK" you should be able to run the installer without problems.
  • Option 4: Lower the suspicion level in the SmartScreen settings (type "SmartScreen settings" in the Start Menu or Start Screen)

If you have trouble following these recommendations, then check

Missing vcruntime140.dll

If Thonny complains about a missing vcruntime140.dll, then you could try installing the Visual Studio 2015 runtime libraries: (vc_redist.x86.exe)

Installing Thonny and Python separately

In the following I'm assuming that you want to install Thonny on Python 3.7 and Python is installed in the default location.

If you are using Windows XP, then you need to use Python 3.4 (e.g., as later Python versions are not compatible with XP. In this case the latest usable Thonny version is 2.1.22 and you should install it with `pip install thonny==2.1.22`.

After installing Python, open a Windows command prompt and enter the following command (assuming you installed Python to C:Python37-32) and hit ENTER:

C:\Python37-32\Scripts\pip install thonnyapp

This command installs the latest thonny and thonnyapp packages to your Python and also creates shortcuts on the Desktop and in the Start menu.

You will see something like this:


If you subsequently want to update Thonny, then open the command prompt again and enter:

C:\Python37-32\Scripts\pip install -U thonnyapp