Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
January 1, 2022 21:05
November 3, 2021 10:01
August 9, 2019 09:39
October 3, 2020 11:59
September 21, 2019 23:19
August 11, 2021 00:43
September 11, 2022 12:49
July 9, 2020 09:32
January 4, 2022 11:29

Wasabi 2D

PyPI PyPI - Python Version PyPI - Wheel


A fast, cutting-edge 2D game engine for Python.

Current features include:

Wasabi2D is based on moderngl(supports OpenGL 4.1+), with pygame 2.0 for some supporting functions, and supporting APIs ported from Pygame Zero.

Docs and Help

Documentation is available at

Join us on Discord for help and announcements!

Quick example

Draw a drop-shadowed circle that follows the mouse:

import wasabi2d as w2d

scene = w2d.Scene()
scene.background = 0.9, 0.9, 1.0

circle = scene.layers[0].add_circle(
    pos=(400, 300),

def on_mouse_move(pos):
    circle.pos = pos

Output of the above program


Use pip to install Wasabi2d from PyPI:

pip install wasabi2d

Please make sure your requirements.txt pins a major version, as Wasabi2D may continue to make breaking API and graphical changes in major versions.


This screenshot shows off polygons, sprites, text and particle effects:

Screenshot as of Wasabi2d 1.0.0

Roller Knight was an entry in PyWeek 28, written with Wasabi2D by Daniel Pope and Larry Hastings:

Roller Knight screenshot

Spire of Chaos was another entry in PyWeek 28 written with Wasabi2D by Daniel Moisset:

Spire of Chaos screenshot