jev-plays
Modular emulator agent framework: PyBoy Pokemon Red first, with structured RAM schemas and Choice-driven tactics at System One latency.
Overview
jev-plays connects TypeSafe Jev to PyBoy with typed RAM maps, Pydantic state, and per-game tactic modules. Pokemon Red is the first shipped world, with navigator and battle Choice schemas documented in the repository layout.
Problem: Retro game agents built on LLMs burn budget and latency parsing text about button presses.
Built for: Streamers, researchers, and emulator hackers who want a modular PyBoy harness for Pokemon Red today and more titles later.
First indexed on Jev Directory: 2026-09-21
Creator and team
- Name
- thumay9700
- Handle
- @thumay9700
How Jev is used
- Role in the product flow
- Emulator tick decision layer for navigation and battle
- Primitives
- ChoiceNoulScore
- State in
- Parsed Game Boy RAM via ram_map.py into structured models (party, map, battle context).
- Decision out
- Typed controller or battle actions from Choice/Noul/Score questions defined per tactics.py.
- PyBoy advances frames
- state.py builds structured observation
- jev_client issues parallel System One questions
- Agent applies inputs and logs telemetry metrics
The framework treats Jev as System One instinct: no tokenized play-by-play, only schemas the emulator can execute. README outlines a YouTube roadmap for Mario, Zelda, and Mega Man using the same BaseGame interface. Bring your own legally obtained Pokemon Red ROM and TYPESAFE_API_KEY, then run the documented CLI entrypoints with uv.
Sourced performance claims
- README cites 50 to 150 ms per decision and sub-dollar full-game cost vs $200+ LLM playthroughs.Source: github.com/thumay9700/jev-plays README
Features and stack
Features
- Modular games/ package with Pokemon Red shipped
- Telemetry for latency, HUD, and cost
- Smart mock engine for offline dev
- pytest suite in repository
- Documented roadmap for additional consoles
Stack
- Python 3.11+
- uv
- PyBoy
- TypeSafe SDK
Links
FAQ
- Which game works today?
- Pokemon Red via PyBoy is the first implemented world per README roadmap checkboxes.
- Does the repo include ROMs?
- No. README requires a legally obtained PokemonRed.gb file.
Related learn guides
Original Jev guidance that pairs with this product pattern.
- Jev use cases
The patterns builders actually search for: moderation, routing, triage, RAG verify, and agent gates.
Related products
Hand-picked neighbors with rich profiles or overlapping tags.