User repository on GitHub
Jev x 海龟汤
- Forks
- 3
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.Homepage
Jev directory
CommunityJev Cookbooks
Soupbase
A Chinese and English lateral-thinking puzzle site hosted by Jev: Choice questions classify player questions and check proposed solutions against required facts, while code enforces confidence thresholds before a puzzle is marked solved.
- Stars
- 9
- Language
- TypeScript
- License
- MIT
- Reading time
- 3 min
- Published by
- Community
- Author
- spoonnotfound
- Last verified
- Sep 2026
Works forJev for Decision gating
Highlights
- Jev answers with four host verdicts - yes, no, not important, and cannot judge yet - and the site shows the model's native confidence.
- Calls go through the Vercel AI Gateway as typesafe-ai/jev, and results return structured options, probabilities, and confidence.
- Ships 50 stories in both Chinese and English, 100 JSON files: 14 beginner, 25 standard, and 11 advanced puzzles.
- Supports BYOK, a deployment-provided key, or both via AI_ACCESS_MODE, and web-created puzzles stay private with revocable share links.
- Tests use an isolated database and simulated models, need no real key, and cover access control, share revocation, version pinning, and credential isolation.
Quickstart
bash
npm ci
cp .env.example .env.local
npm run content:sync
npm run dev # open http://localhost:3000/zhWatch out
MIT-licensed code, but 3 original examples are CC0 and 47 adapted stories plus translations are CC BY-SA 4.0 while user creations are not covered; needs Node.js 24 and npm, and BYOK keys pass through the deployer's server.
Questions about this entry
Short answers drawn from the linked project or page.
The host returns three verdicts, yes, no and not important, and adds cannot judge yet when confidence falls below 0.45, while the site shows the model's native confidence. Proposed solutions are checked against the puzzle's required facts, so marking a puzzle solved is code's decision rather than a sentence the model produced.
No account is needed if you bring your own key. The site goes through the TypeSafe official API, OpenRouter or the Vercel AI Gateway, and BYOK is the default: pick the provider in settings and paste that provider's key. A site-provided key is also possible through AI_ACCESS_MODE, and switching to byok_only and redeploying retires it.
Yes, and the README is explicit that open source does not mean the browser talks to the provider directly: BYOK requests pass through the deployer's server, which can read the key. The application code neither persists nor proactively logs model keys, and the key lives only in page memory, so a refresh or a provider switch means entering it again.
Nothing, and it says so: solutions for public puzzles ship in the repository and the system is not used to prevent cheating. There is also no account system, no anonymous daily quota and no content moderation, so a public deployment leaves spend limits and abuse handling to you. Management links act as passwords, and share links grant play access only and can be revoked.
Three host answers: yes, no, and not important. When the model has no clear lean, a confidence below 0.45, the game judges it as cannot confirm and displays the model's native confidence rather than forcing a choice.
You need Node.js 24 and npm. Run npm ci, copy .env.example to .env.local, npm run content:sync and npm run dev, then open localhost:3000/zh. The default store is PGlite, so no PostgreSQL install is needed, and data lives in the Git-ignored .data/postgres.
AI_ACCESS_MODE is byok_only, site_only or both, with no automatic fallback. AI_SITE_PROVIDER picks the server service, default vercel using AI_GATEWAY_API_KEY and model typesafe-ai/jev, or typesafe using TYPESAFE_API_KEY and jev-1.13.0, or openrouter using OPENROUTER_API_KEY and typesafe/jev-1.13. BYOK players pick their own service.
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
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.
Jev Cookbooks#community#typescript#games
Community
sorrycc/typesafe-snakeTypeScript
sorrycc/typesafe-snakeTypeScriptTwo 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-agentTypeScriptAn 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-oneTypeScriptBrowser lab where every 2048 move is one Jev Choice over the four directions with no heuristic fallback, surfacing the probability distribution, confidence, latency and token cost live.
Jev Cookbooks#community#typescript#games
Community
ARCJ137442/jev-2048TypeScript
ARCJ137442/jev-2048TypeScriptA self-hosted AI trading platform that can put Jev in front of strategy and Quick Trade entry orders as an auditable PASS/REJECT gate, with LLM fallback and deterministic bypasses for exits and protective orders.
Jev Cookbooks#community#python#trading
Community
OpenByteInc/QuantDingerPython
OpenByteInc/QuantDingerPythonAn experimental controller that has Jev choose NES inputs to play Super Mario Bros. from structured emulator telemetry instead of screenshots, logging every decision with probabilities and latency.
Jev Cookbooks#community#python#games
Community
fhshaik/typesafe-marioPython
fhshaik/typesafe-marioPythonFrom 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.