Installing Pygame Zero

On Windows

  1. Install Pygame for Python 3. This is available as a .msi installer from the Pygame Bitbucket.

  2. Install Pygame Zero with pip:

    pip install pgzero


homebrew is a package manager for OSX. It will allow you to install nearly everything you need to get Pygame Zero up and running.

All commands will be entered in a Terminal window.

  1. Install homebrew:

    ruby -e "$(curl -fsSL"
  2. Install Python 3:

    brew install python3
  3. Install the following dependencies, needed for compiling Pygame:

    brew install sdl sdl_image sdl_mixer sdl_sound sdl_ttf
  4. Now pygame can be installed easily using Python’s own package manager, pip3:

    pip3 install hg+
  5. Finally, install Pygame Zero!

    pip3 install pgzero

On Ubuntu Linux

There is a .deb package of Pygame for Python 3 available in this PPA.

  1. Add the PPA to your system sources:

    sudo add-apt-repository ppa:thopiekar/pygame
  2. Update the package list:

    sudo apt-get update
  3. Install the package:

    sudo apt-get install python3-pygame
  1. Install Pygame Zero with pip:

    pip3 install pgzero

On Debian 8 (Jessie)

(There is a .deb package of Pygame for Python 3 in Debian unstable “Sid”. On Jessie it’s relatively simply to compile Pygame yourself.)

  1. Install the dependencies:

    sudo apt-get install mercurial python3-dev python3-numpy libav-tools \
        libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev libsmpeg-dev \
        libsdl1.2-dev  libportmidi-dev libswscale-dev libavformat-dev \
        libavcodec-dev build-essential
  2. Grab Pygame source:

    hg clone
  3. Build Pygame:

    cd pygame
    python3 build
  4. Install Pygame:

    sudo python3 install
  5. Install Pygame Zero with pip:

    pip3 install pgzero

On Raspberry Pi

pgzero is likely to make an appearance in the Raspbian repo before long; until then...

(Starting from a vanilla noobs-install Raspbian)

  1. sudo apt-get update
  2. sudo apt-get install python3-setuptools python3-pip
  3. sudo pip-3.2 install pgzero