Skip to content

Installation

Windows

Download and run the installer from the emzed.spyder release page. It bundles Python and all required dependencies — no separate Python installation needed.

macOS and Linux

We recommend installing into a dedicated virtual environment:

python -m venv emzed-env
source emzed-env/bin/activate
pip install emzed-spyder

Then start the IDE:

emzed.spyder

First startup

On first startup, emzed.spyder will download and install the emzed packages into a dedicated environment. This can take a few minutes.

Before that environment is created, emzed.spyder also shows a first-run configuration dialog. It asks for:

  • the base Python interpreter used to create and rebuild virtual environments
  • the projects root folder where emzed projects are stored

The selected values are saved in ~/.emzed3/config.json on macOS/Linux or %APPDATA%\emzed3\config.json on Windows. You can reopen the same dialog later from a console with emzed_edit_config(). The base interpreter choice is what emzed.spyder uses to create and rebuild project virtual environments later, so pick the Python installation you want those environments to inherit from.

Environment model

emzed.spyder maintains two separate Python environments:

  • Spyder env — runs the IDE itself
  • emzed env (~/.emzed3/remote_venv/ on macOS/Linux, %APPDATA%\emzed3\remote_venv\ on Windows) — runs your code and contains emzed, emzed_gui, and related packages

The emzed env is created and validated automatically. If it is missing or corrupted it will be recreated on the next startup.

After installation, see Using emzed.spyder for the console and banner behavior, and Projects and emzed Extensions for the project workflow and isolated project environments.