toybox.py requires at least Python 3.7 and you need access to pip, the Python package manager. You can check which version you currently have, if any, with:

python --version

On macOS or Linux is this returns a 2.x version, try this instead:

python3 --version

To check if you have pip installed you can do this:

pip --version

Here’s how you can install a newer/supported version of Python and pip:


Installing on macOS

Open a terminal window. All the commands listed here will be typed directly there.

First, make sure that you have the developer tools installed on your machine.

git --version

If running this command offers to you install the developer tools, say yes.

If the command returns the current version for git, make sure you also have Python installed:

python3 --version

This should also report the current version of Python which should be higher or equal to 3.7.

Finally make sure you’re running the latest version of Python’s package manager pip:

python -m pip install --upgrade pip

If you get a message like this one:

WARNING: The scripts pip, pip3 and pip3.9 are installed in '/Users/admin/Library/Python/3.9/bin' which is not on PATH.

Then do the following, keeping in mind you may need to replace the version number for Python with the one given in your warning message.

If the top of your terminal window has bash in it (older macOS versions before Catalina), do:

echo "# Add Python to path" >> .bashrc

echo 'export PATH=$PATH:/Users/admin/Library/Python/3.9/bin' >> .bashrc

and if the top of your terminal Window has zsh in it (macOS Catalina and later), do:

echo "# Add Python to path" >> .zshrc

echo 'export PATH=$PATH:/Users/admin/Library/Python/3.9/bin' >> .zshrc

Then close the terminal window and re-open it for the changed to take effect.


Installing on Linux

Since on Linux many services rely on the installed version of Python, you have to be careful when trying to upgrade to a newer version and do it in a way that doesn’t affect any other versions.

The instructions below apply to Ubuntu Linux 18.04 and 20.04. You may need to tweak them for other distributions. You can find a detailed guide on installing Python 3 and pip over at RealPython.

Open a terminal window. All the commands listed here will be typed directly there.

First make sure your list of packages is up to date:

sudo apt-get update

Install Python 3.8 (If you’re running Ubuntu Linux 20.04 you already have it and you can skip this step):

sudo apt-get install python3.8

Then install the Python package manager pip:

sudo apt-get install python3-pip

And finally make sure you’re running the latest version of Python’s package manager pip:

python3.8 -m pip install --upgrade pip

If you get a warning about the scripts pip, pip3 and pip3.8 not being in your PATH you can safely ignore it.

Close the terminal and reopen it for the changes to take effect.


Installing on Windows

First, make sure that you have Git installed on your machine. Then install the latest release of Python 3. Note that with Windows 7 you may not be able to install any version beyond Python 3.7.

Make sure to check Add Python <version> to path at the beginning and Disable Path length limit at the end of the installation.

Finally open a Windows Terminal or Powershell and make sure you’re running the latest version of Python’s package manager pip:

python -m pip install --upgrade pip

Latest Posts