jev-games
Visual lab where Jev plays Super Mario Bros., Kung Fu and Doom through a plugin system, with code owning buttons and timing.
Overview
Jev Games is a visual lab where Jev plays several games, following on from mario-jev with the same controller style, a zero-shot lab UI, and a plugin split so new games and emulator platforms can be added without rewriting the loop. Bundled titles are Super Mario Bros. on NES using RAM observations, Kung Fu on NES (bring your own ROM) and Doom via ViZDoom (shareware WAD or Freedoom).
Jev makes the decisions while code owns buttons, hold duration and, for Mario, landing interrupts. The lab UI can run, single-step or reset an episode, switch cartridges, list attempts and replay recorded buttons. A scripted baseline lets you check the emulator without spending API calls; the README warns that every Jev decision is a paid request. It uses Python 3.13 with uv and a Bun frontend, and also supports headless play.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | Which action should the player take now?(inferred) | — |
How it works
- Choose a cartridge and policy (Jev or scripted)
- Emulator produces RAM or engine observations
- Jev picks an action; code maps it to buttons and hold time
- Record attempts for replay
Strengths
- Plugin architecture for new games
- Scripted baseline avoids API spend while debugging
- Step and replay controls
Caveats
- Some games require user-supplied ROMs
- Every Jev decision is billed
Getting started
`uv sync`, build the frontend with `bun install && bun run build`, then `uv run jev-games lab` and open http://127.0.0.1:5173.At a glance
- Type
- Project
- Status
- prototype
- Language
- Python
- Runtime
- Emulators (nes-py, ViZDoom) with web lab UI
- Has code
- yes
Use cases and integrations
How curated lists describe it
Visual Jev lab for multiple games and emulator platforms.
hellogumbo/awesome-jev
Frequently asked questions
What does Jev decide?
The next game action; code handles buttons and timing.
Which games are included?
Super Mario Bros., Kung Fu and Doom.
Can I test without spending credits?
Yes, use the scripted policy.
Related projects
Real-time bot battles where you write a fighter's strategy in plain English and a System One model pilots it several times a second.
ProjectbetaTypeScriptBot that plays Red Alert 2 web skirmishes, with code handling mechanics and a decision model making stance, threat and timing calls.
ServicebetaPythonMultiplayer 3D science-fantasy version of Houston's River Oaks District with Jev-powered NPC companion, chauffeur and smart drive.
ProjectbetaTypeScriptBrowser 3D planetary rover sandbox where a TypeSafe controller chooses the next action from complete candidates, versus a baseline.
ProjectbetaTypeScriptDoom runs as a spacecraft payload over real flight software; Jev pilots from the ground every half second while Claude reviews.
ProjectprototypePythonMinecraft agent where Hermes plans, Jev picks one bounded action at a time and a Mineflayer harness validates and executes.
ProjectprototypeJavaScript