pyxel README

The project's README from github.com/kitao/pyxel. As one markdown file: README.md.

Pyxel

GitHub Repo stars GitHub Sponsors Patreon ko-fi

A retro game engine for Python

▸ Website

Pyxel User Examples Pyxel book

Jump game Platformer 30 Seconds of Daylight Megaball Image and tilemap editor Sound and music editor Mesh and motion 3D collision 3D physics

pyxel (kitao/pyxel)

Searching Database…

18.6K ·GitHub
What is this?Pyxel is a retro game engine for Python, built with simple specs inspired by classic game consoles — only 16 colors and 4 sound channels — so you can easily make pixel-art style games.
Is this a Python library or a standalone game-making app?It's a Python package you import into your own scripts to build games; the engine's runtime core is implemented in Rust for speed, not a separate editor application.
How do I start making a game with it?You install the pyxel package for Python and import it into your game code; from there you write your game logic using Pyxel's drawing and sound API.
Do I need anything besides Python to run it?You need Python to write and run your game code; the performance-critical engine itself is compiled from Rust and ships bundled with the package.
Does it support full-color graphics and rich audio like a modern engine?No — by design it caps you at 16 colors on screen and 4 simultaneous sound channels, intentionally mimicking old retro consoles rather than modern hardware.
Can games made with it run in a browser, or only on desktop?Pyxel supports exporting to the web via WebAssembly and WebGL in addition to running as a desktop Python app.
Why limit it to 16 colors and 4 sound channels?It's a deliberate retro-console-style constraint, similar in spirit to engines like PICO-8 and TIC-80, meant to keep pixel-art game creation simple and approachable rather than overwhelming.
Is there a place to see games people made with it?Yes, the README links to a User Examples page where creators share games built with Pyxel.
What are similar projects?bgfx, libgdx, ebiten, raylib, egui, parin, opensmash, crosstl
Creator
kitao
Size
599 MB
Stars
18.6K
Age
8y
Commits · 90 Days