Py Editor for Mac — User Manual

Py Editor 27.0.3 (33) for macOS, the free version you download from pythoneditor.io.

New here? Install the app, then write and run your first script. Everything else on this page answers a single question; open the one you have.

Write and run code

Your first project: write, save and run a script — a complete first session, from an empty project to output you can read.
Run and stop a script — the Run panel, stopping a program, and saving the arguments and working directory a script needs.
Create, rename, move and save files — the project tree, saving, and comparing an earlier save.
Edit code faster — completion, multiple selections, formatting, comments and folding.
Find text and jump to code — search one file or the whole project, replace, and jump to a symbol, a bookmark or a problem.
Preview Markdown, HTML, SVG and notebooks — read a document beside its source.

Use the Python Console and Terminal — try an expression, inspect variables, or run a shell command in the project.
Debug a program — breakpoints, stepping, and reading values while the program is paused.
Run tests and check your code — pytest, Ruff, Mypy and the diagnostics the analyzer reports.
Measure coverage and profile a program — which lines ran, and where the time went.

Open, create or clone a project — the launcher, new projects and cloning from Git.
Set up Helper, a project environment, packages and services — the free Helper, the project .venv, installing packages, Docker and cloud consoles.
Commit and branch with Git — stage, commit, branch and read history.
Ask the AI Assistant about your code — a local model with Ollama, or Gemini and Anthropic with your own key.
Arrange panels and windows — move, hide and detach the panels.

Train and evaluate the AI Vision Lab example — a bundled project that trains a small image classifier.
Run a Mac desktop app: Focus Studio — a PySide6 task list and timer you can read and change.
Learn Python and get help — the bundled lessons, the Python book, and where to send feedback.

Interface map — every part of the project window, named.
Menus and keyboard shortcuts — every command and its shortcut.
Settings reference — application and project settings.
How projects, Python environments and saving work — the ideas behind the app: projects, interpreters, Helper, the two editors and how saving relates to Local History and Git.
Install and update Py Editor — download, first launch, updates.