User repository on GitHub
Playing Pokemon Red using TypeSafe Jev
- Forks
- 2
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
CommunityJev Demos & Experiments
Jev Plays Pokemon — milanboers
Autonomous Pokemon Red demo where Jev reads a compact text state each turn and answers typed Choice and Noul questions that deterministic code maps to PyBoy button presses.
- Stars
- 5
- Language
- Python
- Published by
- Community
- Author
- milanboers
- Last verified
- Oct 2026
About this project
A small autonomous Pokémon Red agent. It uses TypeSafe's System One model, Jev: Jev reads the game state as text, answers typed questions each turn, and deterministic code turns those answers into button presses on a PyBoy Game Boy emulator.
Quoted from the project's README. Read the full README.
- Languages
- Python
Highlights
- No vision or chat history; each turn is a fresh request built from RAM reads, tilemap dialog, and walkability maps.
- Harness re-injects short-term memory with recent dialog hints and recent actions plus explored fraction.
- High-level goals route through A* pathfinding with anti-pacing, stuck detection, and exit probing.
- Today reliably completes the opening from bedroom to Oak lab starter pick and back to Pallet Town.
Watch out
Text-only reconstruction from RAM and tilemaps, not vision. Requires Python 3.14 or later, uv, your own legally obtained Pokemon Red ROM, and TYPESAFE_API_KEY; turbo mode removes the 60 fps cap so the per-decision API call becomes the pacing factor. Copy reviewed against the repository README on 2026-10-04, not from running it.
Questions about this entry
Short answers drawn from the linked project or page.
No. The readme says it reliably plays the opening sequence end-to-end through the starter pick and return to Pallet Town, with deterministic safeguards for goals, menus, and battles, not a full-game completion.
It cannot see the screen. Each turn builds a text state from RAM location and party data, decoded dialog and menu text, collision walkability, object memory with identity and direction, room layout, and a short-term objective, then Jev answers parallel yes-or-no action questions.
Jev gets no growing transcript, so the harness remembers for it and re-injects up to 8 deduplicated dialog pages and the last 12 high-level actions with outcomes, ordered oldest to newest, plus the explored fraction of the room.
Yes to both. Python 3.14 or later plus uv, and your own legally obtained USA copy in roms with expected SHA-1 ea9bcae617fdf159b045185467ae58b2e4a48b9a. TYPESAFE_API_KEY goes in .env, and uv sync pulls the vendored PyBoy wrapper, which is patched but not on PyPI. Run the visible SDL2 window or use --headless, --turbo, --max-turns and --rom. Every per-decision API call is paced by that key, since turbo drops the 60 fps cap.
uv run jev-plays-pokemon, plus --rom for a custom ROM path, --model to pick another Jev model such as jev-preview, --headless for console-only, --max-turns to stop after N decisions, --turbo to drop the 60 fps cap, and --no-screenshots. Ctrl+C stops cleanly within a fraction of a second and saves nothing to the save file.
Jev picks a high-level goal each turn through a Choice: advance_text, a talk_to goal, explore, reach_exit, or wait, and code executes it mechanically with A* pathfinding over the verified room map. In menus and battles Jev instead picks a single button through eight atomic Noul questions, with confidence and margin gating.
Front doors and stairs look like solid walls on the collision map, so the agent reads the live RAM warp table every frame to derive known exits and offers per-exit goals. It handles step-triggered and boundary-triggered warps, never becomes permanently blocked by a bump, never immediately reverses the last step, and on being stuck presses B, waits, then re-routes.
Other listings of this project
Forks and copies of this project in the directory. This entry is the canonical one.
1GitHub stars
A Pokemon Red agent that boots a ROM, picks each move with Jev, and streams video plus a live decision panel from a small read-only local HTTP server.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
zbloss/jev-plays-pokemonPython
zbloss/jev-plays-pokemonPythonMore Jev resources like this
49GitHub stars
StarCraft II research repo combining Jev action selection with optional Astra plans across full-game macro control and SMAC-Hard micromanagement, with videos, replays, and a paper.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
sc2musa/Jev_StarPython
sc2musa/Jev_StarPython22GitHub stars
Terminal harness that checks ROS 2 robots with deterministic health tests, capability descriptions, SQLite history, and optional Jev evidence routing.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
YueBit/robodiag-harnessPython
YueBit/robodiag-harnessPython19GitHub stars
MCP server where one browser_goal call hands a URL, a goal, and code-checked assertions to a server-side loop driven by a decision model over live page elements.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
jiawei686/jev-ultrafast-mcpPython
jiawei686/jev-ultrafast-mcpPython16GitHub stars
Local Qwen3.5 decision models in 0.8B and 2B sizes with fitted temperatures, systemone-shaped server, playground, guard, MCP tools, and eval harness.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
lawrence3699/jev-stylePython
lawrence3699/jev-stylePython22GitHub stars
Independent open-source local decision model inspired by Jev, with a spark-s1 family plus smaller control models for agent gates, served locally with probabilities and policy actions.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
abhishek085/open-spark-jevPython
abhishek085/open-spark-jevPython114GitHub stars
Browser agent where Jev picks each action from indexed page candidates while an LLM plans and reads, returning cited answers or schema-checked data with credential controls.
Jev Demos & Experiments#community#jevbest#catalog-import
Community
agent-labs-dev/fastbrowsePython
agent-labs-dev/fastbrowsePythonFrom the Jev guides
Original write-ups on what this entry is for.
A game tick is a state plus a legal action list. How Clash Royale, Minecraft, and the earlier Mario, Pokémon, StarCraft, and drone loops ask Jev one step at a time.
Jev Demos & Experiments#gaming#agents#control
Read article
From the Jev community
Posts from builders shipping with Jev right now.