Repolode
Submit
plbrault

plbrault/youre-the-os

A Python game where you play the operating system, scheduling processes and managing memory and I/O events in the browser or on desktop.

View on GitHubWebsite
Stars
2,690
Forks
93
Open issues
1
Last commit
2 hours ago

What is it?

You're the OS is a game in which you act as the operating system of a computer. Your job is to manage processes, memory and I/O events so that no process sits idle for too long; if the user gets impatient, they reboot you.

The game can be played directly in a web browser or on itch.io. The desktop version is built with pygame and runs from a local clone of the repository using pipenv.

The desktop version also exposes an API for writing automation scripts that play the game, and a sandbox mode lets developers jump straight into a custom stage for testing.

Key features

  • 01Manage process scheduling, memory and I/O events as the OS.
  • 02Play in the browser via WebAssembly or as a desktop app.
  • 03Desktop version exposes an API for automated scripts.
  • 04Sandbox mode runs custom stages for development.
  • 05Unit tests and a pylint setup are included.

Use cases

  • Playing a light puzzle-style game that teaches OS concepts.
  • Learning how process scheduling and memory management work through gameplay.
  • Writing automation scripts to experiment with game strategies.
  • Studying a pygame project that also targets WebAssembly.

Quick start

  1. 1

    Install Python 3.14, pipenv, and create an empty .venv directory at the project root

  2. 2

    Install dependencies

    pipenv sync --dev
  3. 3

    Run as a desktop app

    pipenv run desktop

Things to know

  • Requires Python 3.14; other versions are not guaranteed to work.
  • Licensed under GPL-3.0, a copyleft license.
  • The main branch can be unstable, so use a release tag for a stable version.

In collections

Learning & education tools

Topics

#game#operating-systems#pygame#python#webassembly#education#os

FAQ

What is youre-the-os?
A Python game where you play the operating system, scheduling processes and managing memory and I/O events in the browser or on desktop. You're the OS is a game in which you act as the operating system of a computer. Your job is to manage processes, memory and I/O events so that no process sits idle for too long; if the user gets impatient, they reboot you.
Is youre-the-os free to use? What license does it have?
youre-the-os is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is youre-the-os still maintained?
Actively maintained. The last commit to youre-the-os was on Nov 7, 2026.
What can I use youre-the-os for?
Playing a light puzzle-style game that teaches OS concepts. Learning how process scheduling and memory management work through gameplay. Writing automation scripts to experiment with game strategies. Studying a pygame project that also targets WebAssembly.
How do I install youre-the-os?
Install Python 3.14, pipenv, and create an empty .venv directory at the project root Install dependencies: pipenv sync --dev Run as a desktop app: pipenv run desktop
Where can I get youre-the-os?
The source code and installation instructions are on GitHub: https://github.com/plbrault/youre-the-os

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects