Skip to main content

game-ready client-server architecture and UDP-based network protocol - built to be easy to use, lightweight, fast, scalable and reliable

Project description

Build Status Azure DevOps tests (branch) Azure DevOps coverage (branch) Code style: black PyPI


Python Game Server

A package for Python 3.6+ that contains a game-ready client-server architecture and UDP-based network protocol.

It deals with problems such as package loss or network congestion so you don't have to. Instead it gives you a high-level API to easily connect clients and backends that share a synchronized game state and exchange events. The async framework for this one is curio, which I highly recommend.

PyGaSe is built to be easy to use, lightweight, fast, scalable and reliable. You can build a fast-paced real-time online game with this. You can also build a large-scale MMO with thousands of clients if you like.

I'm actively developing PyGaSe in the context of several Indie game projects and I'm happy to share it.

BREAKING CHANGE: Version 0.2.0 is basically a new API and updating from 0.1.9 or lower will break you code. It is also much more stable, flexible and powerful, so make sure to use 0.2.0 or higher.


pip install pygase

or better yet poetry add pygase. Seriously, use poetry, it's a revelation.


API Reference & Tutorials

For API documentation and a Getting Started section go here.


This example game implements an online game of tag, in which players can move around, while one of them is the chaser who has to catch another player. A player who has been catched becomes the next chaser and can catch other players after a 5s protection countdown.

Run first, then run in additional terminal sessions to add players. Only use the same player name once.

Debugging & Logging

You can use the standard logging module. On level INFO you will get logging output for events such as startups, shutdowns, new connections or disconnects. On DEBUG level you get detailed output right down to the level of sending, receiving and handling single network packages.

Debug logs are also a good way to understand the inner workings of PyGaSe.



  • improved documentation
  • minor logging fixes


  • sticking to SemVer from here on out
  • logging added using the standard logging module
  • improve event handler arguments
  • Backend class added to reduce server-side boilerplate
  • various bugfixes


  • complete overhaul of pygase 0.1.x with breaking API changes

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pygase, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size pygase-0.3.1-py3-none-any.whl (26.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pygase-0.3.1.tar.gz (23.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page