Automated README summary
Automatically summarized from the README on 20 Sept 2026; not a run by jevbooks. Run instructions and author-reported outcomes still need verification.
What it is
An experimental controller that lets TypeSafe's Jev model directly choose NES controller inputs for the original Super Mario Bros., using emulator telemetry and RAM rather than screenshots.
How it uses Jev
Each decision, Jev receives compact object-centric JSON (player, trajectory, hazard, terrain, reaction_timing, recent_control, episode) and evaluates three judgments: a Choice selects the next controller macro, a Noul estimates whether a forward jump is useful, and a Score measures immediate danger. The chosen action is sent to the emulator, which advances several frames.
Primitives:choicenoulscore
Technique worth stealing
Translate emulator telemetry and RAM into compact, object-centric JSON instead of screenshots, keeping timing arithmetic in code.
Try it
py -3.13 -m venv .venv; .venv\Scripts\python -m pip install -e ".[mario,dev]"; set TYPESAFE_API_KEY; .venv\Scripts\typesafe-mario play --env SuperMarioBros-1-1-v0 --frames-per-decision 8
Model judgments from README excerpts
Project signals use repository metadata, an existing summary and the first 700 README characters, not the full project. “Not found” means not detected in that material; it does not establish absence. These are the original judgments with recorded models and dates, not source audits or run results.
Models & evaluation dates
- Inclusion gate
jev-1.13.0- Project signals
jev-1.13.0- Category
jev-1.13.0- Pattern tags
jev-1.13.0
Evidence
These signals use repository metadata, an existing summary and at most 700 cleaned README characters. ≥ 0.60 means reported in that excerpt; ≤ 0.40 means not found there. The middle band is inconclusive. None is a source-code audit or a test result. The runnable-tool question excludes research experiments; the recommendation question asks for a learning shortlist, not a quality verdict.
- Jev is core to the projectFound in material0.94
- Shows a System One patternFound in material0.83
- Describes handling uncertaintynot found in the excerpt0.04
- Reports measured numbersnot found in the excerpt0.07
- Is a runnable toolnot found in the excerpt0.34
- Top-10 learning shortlist signalunclear0.52
- Is a replica of the modelnot found in the excerpt0.08
- Solves a common problem (0–2)score on a 0–2 scale0.03 / 2
- About JevFound in material0.98
no-judgment band (0.40–0.60)
no-judgment band (0.40–0.60)
The Jev model and date for each judgment stage are listed above. Card written by DeepSeek V4.1 Flash from the README on 20 Sept 2026.