Aivar Annamaa edited this page Jan 12, 2019 · 4 revisions

For classroom use see alternative deployment options.

Installing Thonny and Python bundle

Thonny bundles are supported on 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 under Program Files, that's why installer proposes a folder under 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.

Short story is that currently Windows 8 and 10 may be suspicious about 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 eg. Firefox, you should see the usual confirmation you've accustomed to see in previous Windows versions).

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

How to work around SmartScreen Filter?

  • Option 1: If you run 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 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 warning with no option to confirm your intention, or were asked to provide 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 "General" tab. After clicking "OK" you should be able to run installer without problems.
  • Option 4: Lower the suspicion level from SmartScreen settings (type "SmartScreen settings" in Start Menu or Start Screen)

If you have trouble following these recommendations, then check

Missing vcruntime140.dll

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

Installing Thonny and Python separately

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

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

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

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

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

You will see something like this:


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

C:\Python37-32\Scripts\pip install -U thonnyapp
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.