How To Install Packages


With the introduction of version 3.0, Thonny now comes with a built-in package manager. On both Windows and MacOS, the package manager can be accessed from the top menu bar by going to:

Tools --> Manages Packages...

This will open a new window where you can use one of two methods to install packages:

  • Installation via the Python Package Index (PyPI)
    • PyPI contains the overwhelming majority of all well-known packages used by Python developers. If you know the name of your package, you can look for it by using the search box at the top of the Manage Packages... window (type the name of the package into the search bar and click "Find package from PyPI").
    • If PyPI is able to locate the package, the window will change to display information about the package. Click the "Install" button to complete the installation of the package.
  • Installation from a local package file
    • In some cases, PyPI won't be able to find obscure packages (or you may have custom packages of your own). In this case, you'll need to install them manually. In the Manage Packages... window, there is a link labeled "here" under the "Install from local file" header. Click this link and it will open a file browser. Navigate to where your package lives (usually it will be a .whl file) and double-click it. A dialog box will open and a whole bunch of commands will fly by (decompressing the package, verifying its integrity, etc). Assuming it is successful, when the dialog box closes you should be taken to a new window that will confirm the package was installed successfully. If the install fails, there will be a message in the dialog box explaining why.


(If you reached this page using go/thonny and intended to find the Thonny download page, you can now find the deprecated Middlebury build of Thonny here.)