Skip to content


Repository files navigation

GitHub Test Status PyPI PyPI - Downloads Read the Docs

Pygame Zero

A zero-boilerplate games programming framework for Python 3, based on Pygame.

Some examples

Pygame Zero consists of a runner pgzrun that will run a Pygame Zero script with a full game loop and a range of useful builtins.

Here's some of the neat stuff you can do. Note that each of these is a self-contained script. There's no need for any imports or anything else in the file.

Draw graphics (assuming there's a file like images/dog.png or images/dog.jpg):

def draw():
    screen.blit('dog', (10, 50))

Play the sound sounds/eep.wav when you click the mouse:

def on_mouse_down():

Draw an "actor" object (with the sprite images/alien.png) that moves across the screen:

alien = Actor('alien')
alien.pos = 10, 10

def draw():

def update():
    alien.x += 1
    if alien.left > WIDTH:
        alien.right = 0


See installation instructions.


The full documentation is at

Read the tutorial at for a taste of the other things that Pygame Zero can do.


The project is hosted on Github:

If you want to help out with the development of Pygame Zero, you can find some instructions on setting up a development version in the docs: