User repository on GitHub
Snake auto-played by TypeSafe's Jev model: one System One choice per tick, legal moves and facts generated in code
- Forks
- 5
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.
Jev directory
CommunityJev Cookbooks
Jev Plays Snake
A browser Snake game where code computes the legal moves, food distance, and reachable space and Jev picks one move per tick with a single Choice question; a late answer leaves the snake going straight.
- Stars
- 24
- Language
- TypeScript
- Reading time
- 3 min
- Published by
- Community
- Author
- sorrycc
- Last verified
- Sep 2026
About this project
TypeSafe's Jev (a System One decision model, not an LLM) plays Snake in real time. Code generates the legal moves and exact facts about each one (food distance, reachable cells via flood fill, dead ends); Jev picks one with a single choice question per step. If the answer misses the tick deadline, the snake just keeps going straight. The API key lives only in the Hono proxy (server/index.ts); the browser calls /api/decide. src/game/engine.ts – pure snake engine (seeded RNG)
Quoted from the project's README. Read the full README.
Works forJev for Classification
Highlights
- A fixed-clock controller asks Jev at tick start and plays whatever answer arrived by tick end; a miss just keeps the snake moving straight.
- The code generates exact per-move facts: food distance, reachable cells via flood fill, and dead ends, then asks one Choice question.
- The TypeSafe API key lives only in a Hono proxy server; the browser calls /api/decide.
- The engine is pure and seeded, with controller tests and a typecheck script runnable via pnpm test and pnpm typecheck.
Quickstart
bash
cp .env.example .env
pnpm install
pnpm devWatch out
No license file, so reuse terms are unclear. Needs a TypeSafe API key plus pnpm and Node; the game asks Jev once per tick and has no offline mode.
Questions about this entry
Short answers drawn from the linked project or page.
Code does the analysis, Jev does the choosing. The engine computes legal moves, food distance, reachable cells by flood fill and dead ends, and Jev picks one with a single choice question per step. Miss the tick deadline and nothing crashes: the snake just keeps going straight.
No. The key lives only in the Hono proxy at server/index.ts, and the browser calls /api/decide instead. You still need a TYPESAFE_API_KEY in .env plus pnpm and Node, and there is no offline mode: the game asks Jev once per tick.
There is no license file in the repository, so reuse terms are genuinely unclear and you should treat it as all rights reserved until the author adds one. The pieces worth copying sit in separate files: a pure seeded engine in engine.ts and the move analysis in analysis.ts.
src/jev/prompt.ts builds the state and choice question and ships strategy presets, but the README does not list what those presets contain or how they differ from each other. The engine is seeded and the controller loop is fixed-clock, so pnpm test and pnpm typecheck cover the parts that are checkable.
Copy .env.example to .env, set TYPESAFE_API_KEY, then pnpm install and pnpm dev. Two servers come up: the web app on http://localhost:5188 and the Hono proxy on http://127.0.0.1:8787. pnpm test runs the engine and controller tests and pnpm typecheck runs tsc, neither of which needs a key.
src/components/ holds a dark dashboard built around the decisions: Board renders the game on a canvas and interpolates the snake between ticks so the animation stays smooth whatever the timing, and StrategyBar, StatusCard, CurrentDecision and DecisionFeed sit alongside it. Every decision on screen came from a POST to /api/decide.
It uses the official JavaScript SDK. The Hono proxy at server/index.ts exposes POST /api/decide through @typesafe-ai/sdk rather than calling the API with raw requests, and the browser-side code never touches that SDK at all; it only posts to the local endpoint. Analysis and engine code stay independent of the transport.
Reactions & coverage
Posts, threads, and videos about this entry from around the web.
Hacker News: Software Bombe and live Enigma demo where Jev ranks cribs and judges plaintext.
ag_212 pointsShow HN: Jev as the Bletchley Park Analyst: A Software Bombe on EnigmaRead the thread on Hacker NewsHacker News: Show HN for public Minecraft PvP where a diffusion LM picks moves from structured state.
2 pointsShow HN: Minecraft PvP against DiffusionGemma-as-Jev, 24 ms per decisionRead the thread on Hacker NewsHacker News: Show HN: Jev finished a Pokémon Red run, with the Hall of Fame stats on the landing page.
pancomplex272 pointsShow HN: Jev Plays Pokémon RedRead the thread on Hacker NewsHacker News: Show HN: a mouse colony where each next move is Jev or a fixed rule.
1 pointShow HN: Jev-mice – mouse colony simulation using Jev and deterministic engineRead the thread on Hacker NewsMore Jev resources like this
Two WebAssembly builds of the Chocolate Doom 3.1.1 engine play the same Freedoom map from the same initial state, with a Jev Choice decision picking each tactical macro and a local controller turning it into inputs.
Jev Cookbooks#community#typescript#games
Community
lukaske/jev-doom-agentTypeScript
lukaske/jev-doom-agentTypeScriptA side-by-side T-Rex game where local Laya runs on Apple Silicon through MLX and hosted Jev uses the TypeSafe API, showing choices, latency, survival streaks, and crash replays on one course.
Jev Cookbooks#community#python#games
Community
virajbhartiya/laya-vs-jevPython
virajbhartiya/laya-vs-jevPythonAn observable stealth game where Jev supplies guards' split-second judgments while deterministic code owns the 30 Hz simulation, validates every proposal, and exposes each decision in a Decision Lens.
Jev Cookbooks#community#typescript#games
Community
AbdelStark/heist-oneTypeScript
AbdelStark/heist-oneTypeScriptFour board games against Jev where the model picks the move and code keeps the rules: tic-tac-toe, Connect Four, Battleship, and Wordle.
Jev CookbooksPlayground#community#playground#games
Community
A multiplayer demo workflow builder for Jev built with Liveblocks: wire Jev and LLM steps together, call the workflow through a REST API, and preview test runs with shared state and cursors.
Jev Cookbooks#community#typescript#demo
Live Hyperliquid desk across five isolated wallets where each tick packages the book, tape, and position as state and Jev answers Choice questions for long/short, open/close/hold, and leverage; hold sends no order. A missing private key means a dry run.
Jev Cookbooks#community#typescript#trading
Community
aowang-ai/jev-tradeTypeScript
aowang-ai/jev-tradeTypeScriptFrom the Jev guides
Original write-ups on what this entry is for.
From the Jev AI model community
Posts from builders shipping with Jev right now.