Installation

The μEdition is built in the Python programmling language, so to use it, you need to download and then install a version of Python on your system. Go to https://www.python.org/downloads and then download the latest version of Python and install it.

If you already have a version of Python installed on your system, then you can just use that. The μEdition supports all versions of Python that are currently supported[1]. It is likely that it will also work on older versions, but this cannot be guaranteed, so if you have a Python version that is out of date, now is a good time to update that.

The μEdition uses a number of existing libraries to provide you with the full functionality. To simplify the process of installing these dependencies, the μEdition uses Hatch to manage the environment that the μEdition is installed into. Follow the instructions on https://hatch.pypa.io/latest/install/ to install Hatch for your operating system.

Before we move on to actually creating your μEdition, it is a good idea to test that the installations were successful. To test that Python is correctly installed, open a terminal and then run the following command[2]:

$ python --version

If this shows the installed Python version, then the Python installation was successful. Next, run the following command to test that Hatch was correctly installed:

$ hatch --version

If this outputs the Hatch version, then Hatch has also been successfully installed.

If either of the two installations did not work correctly, then please check the respective software’s documentation and support forum. Unfortunately the variety of systems out there means that we cannot provide useful support for these issues.

---

[1]

See here for the current Python version support status

[2]

Do not include the $ when running the command. The $ just indicates that the rest of the line is to be entered as a command on the commandline.