terrarium
Browser sandbox where Jev picks a small creature's control each step from a world-state JSON while code runs the world.
Overview
Terrarium is a sandbox in which Jev controls a small creature. Code runs the world and Jev only picks a button. Each step sends the world as JSON, including species profile, position, eight drives, every object with distance and direction, and recent events, along with one Choice over eleven controls and a fan-out of per-object questions: a threat Score, edible and drinkable Nouls, an interest Score and a shelter Noul, plus the most pressing drive, an in-danger Noul and a mood Score, all in one round trip.
Code walks the control distribution from the top and takes the first control the world can honour, resolving targets from Jev's per-object judgments. Users can drop free-text objects, which Jev classifies into properties such as food type, poison or heat, with real consequences if Jev is wrong. Every decision is logged with state, questions, probabilities, latency, tokens and any code override. The author built it to measure Jev's speed with large requests and the accuracy of its snap judgments, with games, live apps and robots in mind.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | Which of the eleven controls should the creature press? | — |
| Yes / no | Is this object edible? | — |
| Score | How threatening is this object? | — |
| Yes / no | Is the creature in danger? | — |
How it works
- Serialize the world state to JSON each step.
- Ask one control Choice plus per-object and drive questions in one request.
- Code takes the highest-ranked control the world allows and resolves targets.
- Log the full decision record for inspection.
Strengths
- Full decision log with latency and probabilities.
- Runs with a mock brain without a key.
- No dependencies beyond Node.
Caveats
- Sandbox for measurement, not a game engine.
- No licence stated.
Getting started
git clone https://github.com/TheGali/terrarium.git && cd terrarium && node serve.mjs 5180, then open http://localhost:5180.At a glance
- Type
- Project
- Status
- prototype
- Language
- JavaScript
- Runtime
- Node server + browser
- Has code
- yes
Use cases and integrations
How curated lists describe it
A sandbox where a TypeSafe System One model presses the controls of a small creature. Code runs the world.
hellogumbo/awesome-jev
Frequently asked questions
What does Jev control?
Only which of eleven controls the creature presses, plus judgments about objects; code runs the world and resolves targets.
Can I run it without a key?
Yes, a mock brain plays without a TypeSafe key.
What is logged?
Each step's state, questions, probabilities, latency, token count and whether code overruled the model.
Related projects
Real-time bot battles where you write a fighter's strategy in plain English and a System One model pilots it several times a second.
ProjectbetaTypeScriptBot that plays Red Alert 2 web skirmishes, with code handling mechanics and a decision model making stance, threat and timing calls.
ServicebetaPythonMultiplayer 3D science-fantasy version of Houston's River Oaks District with Jev-powered NPC companion, chauffeur and smart drive.
ProjectbetaTypeScriptBrowser 3D planetary rover sandbox where a TypeSafe controller chooses the next action from complete candidates, versus a baseline.
ProjectbetaTypeScriptDoom runs as a spacecraft payload over real flight software; Jev pilots from the ground every half second while Claude reviews.
ProjectprototypePythonMinecraft agent where Hermes plans, Jev picks one bounded action at a time and a Mineflayer harness validates and executes.
ProjectprototypeJavaScript