prometeu-runtime/test-cartridges

PROMETEU Test Cartridges

This directory contains example cartridges and test suites to validate the behavior of the PROMETEU runtime and development tools.

Available Cartridges

🟩 color-square

A simple cartridge that demonstrates:

• System initialization.
• Rendering a colored square in the framebuffer.
• Basic execution loop.

Cartridge Structure

A PROMETEU cartridge (in its unpacked form) generally consists of:

• manifest.json: Application metadata (ID, title, version, mode).
• program.pbc: Compiled bytecode for the PROMETEU VM.
• assets/: Resources such as tiles, sprites, and audio samples.

How to use

You can run any of these cartridges using the main CLI:

prometeu run test-cartridges/<cartridge_name>