2. Education tools
  3. thonny


Clone wiki

thonny / Windows

Using Thonny on Windows

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.

The installing and uninstalling procedures are really standard, nothing much to say about this.

The slightly unusual thing with Windows installer is that it 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 http://msdn.microsoft.com/en-us/library/aa367559%28v=vs.85%29.aspx)

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 http://www.howtogeek.com/123938/htg-explains-how-the-smartscreen-filter-works-in-windows-8/ 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-1.0.6.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 http://www.tenforums.com/tutorials/5357-unblock-file-window-10-a.html

Installing Thonny and Python separately

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


If you are using Windows XP, then Python 3.4 (eg. https://www.python.org/ftp/python/3.4.4/python-3.4.4.msi) is your only choice, as Thonny is not compatible with earlier Python versions and later Python versions are not compatible with XP.

After installing Python, open Windows command prompt:


and enter following command (assuming you installed Python to default location) and hit ENTER:

C:\Python34\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:\Python34\Scripts\pip install -U thonnyapp