fhshaik/typesafe-mario
A TypeSafe/Jev agent that plays Super Mario Bros. from structured emulator state.
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
An experimental controller that lets TypeSafe's Jev model directly choose NES controller inputs for the original Super Mario Bros. The model does not receive screenshots. The harness translates emulator telemetry and RAM into compact, object-centric JSON containing Mario's motion, jump trajectory, upcoming enemies, terrain, measured response delay, recent-control results, and episode progress. Jev chooses one of the legal controller actions, the emulator advances several frames, and the loop repeats. The raw local tile grid remains available in debug logs and the UI, but is not duplicated in the model input. The initial action set is intentionally small: This repository contains no Nintendo ROM or other copyrighted game data. You are responsible for ensuring that your emulator and game files are obtained and used lawfully. Inspect the exact JSON and text that will be sent to TypeSafe without launching the game or calling the API: Run World 1-1 with Jev making…
Read the full README ↗ · Preview checked 2026-10-29T05:22:46.183Z
Inside the original README — Document outline
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Documentation belongs to its respective authors. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
A TypeSafe/Jev agent that plays Super Mario Bros. from structured emulator state.
Repository facts
- Owner
- fhshaik
- Primary language
- Python
- Stars
- 362
- Forks
- 37
- Open issues + pull requests
- 2
- License
- Not reported — inspect the license file
- Archived
- No
- Default branch
- main
- Created
- 2026-09-16T04:57:42.000Z
- Last push
- 2026-09-16T04:59:33.000Z
Topics and intended use
No topics were included in the latest source metadata.
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-09-23T12:03:29.066Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.
Related repositories
EbookFoundation/free-programming-books
donnemartin/system-design-primer