# Thonny

A beginner-friendly Python IDE with a bundled interpreter, variable inspection, step-by-step debugging, expression visualization and a graphical package manager.

> This is the Markdown version of the Thonny page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/thonny>

- **Latest version**: `5.0.1`
- **Developer**: Aivar Annamaa
- **Homepage**: <https://thonny.org/>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask thonny`
- **30-day installs**: 322
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/thonny/thonny/releases/download/v5.0.1/thonny-5.0.1-arm64.pkg>
- **SHA-256**: `d82bcac04b9e010695fbc7a7d176188a5aa731bdcff163f4d3d7a32c6beefe50`
- **Installer packages**: thonny-5.0.1-arm64.pkg

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "delete": "/Applications/Thonny.app",
          "pkgutil": "org.thonny.Thonny.component",
          "quit": "org.thonny.Thonny"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "thonny-5.0.1-arm64.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "thonny-5.0.1-arm64.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Saved Application State/org.thonny.Thonny.savedState",
            "~/Library/Thonny"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Thonny is a Python integrated development environment designed for learning programming. Its simplified initial interface lets beginners start writing and running code without configuring a separate toolchain. The official macOS 5.0.0 installers bundle Python 3.14 and are distributed separately for Apple silicon and Intel Macs.

### Understand what the program does
The Variables view shows how commands change Python variables. The debugger can execute a program step by step without first setting breakpoints, using large or small steps that follow the program structure. Small steps visualize expression evaluation, while stepping into a function opens a separate view with local variables and a code pointer. Optional object-reference views help explain the relationship between names, addresses and values.

### Editor and tools
Syntax-error highlighting makes unclosed quotes and parentheses easier to find. Variable highlighting distinguishes local and global names, and code completion helps learners explore APIs. A prepared system shell handles interpreter paths, while Tools → Manage packages provides a graphical interface for installing third-party packages. The project also supports extensions; third-party plug-ins are not endorsed or maintained by Thonny's developers.

### Installation and upgrading
The official 5.0.0 macOS installers require macOS 10.15 or later. Upstream recommends uninstalling Thonny 4 before installing Thonny 5. If the previous configuration points to a removed Python executable, select the new interpreter using the control in the lower-right corner of the window. Version 5 is primarily a compatibility and bug-fix release, not the planned feature expansion; new features were moved to the version 6 milestone.

Thonny's main author is Aivar Annamaa, with contributions from the open-source community.

### Sources
- [Official features and credits](https://thonny.org/)
- [Source repository](https://github.com/thonny/thonny)
- [Official 5.0.0 release and upgrade instructions](https://github.com/thonny/thonny/releases/tag/v5.0.0)
- [Homebrew cask](https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb)

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 5.0.1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · Checked 2026-11-22
  - <https://github.com/thonny/thonny/releases/download/v5.0.1/thonny-5.0.1-x64.pkg>
  - SHA-256: `1bb31ae9fe48c712980e57b0353a051c6e2615ba2cebc164179db134588ac033`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 5.0.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · Checked 2026-11-22
  - <https://github.com/thonny/thonny/releases/download/v5.0.1/thonny-5.0.1-arm64.pkg>
  - SHA-256: `d82bcac04b9e010695fbc7a7d176188a5aa731bdcff163f4d3d7a32c6beefe50`

## Thonny security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/thonny/thonny> · Open source: Yes — <https://github.com/thonny/thonny> · Checked 2026-11-14

## Uninstall

- `brew uninstall --cask thonny`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Installer receipts (pkgutil): `org.thonny.Thonny.component` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `/Applications/Thonny.app` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask thonny`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Saved Application State/org.thonny.Thonny.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Thonny` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 5.0.1 (2026-10-28)

Updates bundled Python and Tk, fixes macOS dialogs and Unicode handling, and repairs plugin management and ESP MicroPython installation.

- macOS and Windows bundles now include Python 3.14.10 and Tk 9.0.4 instead of Tk 8.6.17. This fixes dialog freezes on macOS 27 and Unicode issues, including emoji find/replace.
- Fixes the Plugin manager's `NameError: name 'req' is not defined` and restores installation of local ESP MicroPython images.
- Updates bundled dependencies and requires esptool 5.0 and Python 3.10. Windows 7 and 8 are no longer supported, including separate Python installations.

[Official release notes](https://github.com/thonny/thonny/releases/tag/v5.0.1)

## Facts and sources

- <https://opennavo.com/apps/thonny>
- <https://opennavo.com/apps/thonny/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/t/thonny.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/thonny>
- <https://github.com/thonny/thonny> · Checked 2026-11-14
