- JavaScript 98.1%
- CSS 1.2%
- HTML 0.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- ollama's OpenAI shim ignores options/num_ctx entirely (measured: model loads at 4096 either way), so 8192 tokens live in a derived model: deploy/ollama.Modelfile (fifo-gemma FROM gemma3:4b). - LLM_EXTRA_BODY keeps only what the shim honors: reasoning_effort null, keep_alive. Comments/docs re-measured to match. |
||
| .omp | ||
| bubble-regression | ||
| bubble-root-verify | ||
| bubble-symbol-verify | ||
| deploy | ||
| docs | ||
| openspec | ||
| public | ||
| scripts | ||
| shots | ||
| synth | ||
| test | ||
| tools | ||
| world | ||
| .env.example | ||
| .gitignore | ||
| .keep | ||
| .omp-brief-t_7b031d9e.md | ||
| .surface-audit-prompt.md | ||
| AGENTS.md | ||
| decide.mjs | ||
| demo.mjs | ||
| GLOSSARY.md | ||
| IDEA.md | ||
| loop.mjs | ||
| model.mjs | ||
| prompt.mjs | ||
| README.md | ||
| salience.mjs | ||
| server.mjs | ||
| world.mjs | ||
Fifo
A kakapo who runs himself. Inspired by Pino, the autonomous kiwi bird — same loop, different bird: Fifo is a flightless nocturnal parrot who lives on a small island you can walk around in 3D, decides his own night, writes a diary you can read, and remembers the people who talk to him and leave him things.
node server.mjs # Node 20+, nothing to install
# fifo is awake
# visit him: http://localhost:4780
Open the URL. You spawn as a visitor on his island — WASD/arrows to walk, drag the mouse to look, O to fly. You'll find his burrow, the shrine, the noodle shop, the cinema, the library, the town square and the shore, all joined by streets and tracks. Fifo waddles between them doing whatever he decided to do.
You can:
- walk up to him — he notices you standing there (it lands in his observations and may pull him toward you, or not — his call)
- say something — it waits on his attention; if he chooses to answer, you see what he actually said. Nothing is scripted.
- leave an offering at the shrine — it appears in the scene, he can discover and inspect it, and he remembers who left it.
- give your name — he remembers returning visitors: what they left, what was said.
- read the diary — the feed card has a link; it's his real
state/diary.md.
The top bars are his five feelings — fullness, energy, wonder, joy, calm — read straight from his observation. The left card is "right now": what he's doing and what happened earlier. Bottom left is a minimap (purple = him, red = you).
Copy .env.example to .env. Any OpenAI-shaped chat API works — it's currently set to a local omlx server (Qwen3.8-Flash-Next); the Groq defaults are in .env.example:
LLM_URL=http://localhost:8000/v1/chat/completions
LLM_API_KEY=<your server key>
MODEL=Qwen3.8-Flash-Next-oQ4h-mtp
With no .env he still lives his life on deterministic stand-in decisions (the page says "dry-run"). With a key, the model decides every ~45 s (FIFO_TICK_MS to tune).
How it works
┌──────────┐ OBSERVATION ┌────────┐
│ world │ ───────────────▶│ mind │ prompt: only moves on offer, names not ids
│ (world.mjs)│ │(model call)│
│ │◀─────────────── │ │ ACT {action, params}
│ state + │ ACTION_RESULT └────────┘ JSON only: {consider, do, because}
│ memory │ success + words, or refusal + reason
└────┬─────┘
│ SSE after every turn
┌────┴─────┐
│ your │ 3D clearing, his speech, his diary
│ browser │ you say/offer → into his next observation
└──────────┘
Every turn: the world says what's true in words → the model picks one move → the world does it or refuses → the result lands in "what happened earlier" and the next observation. Refusals are recorded too, or he'd try the same move again.
world/— manifest (every move he can make) and starting observationworld.mjs— the clearing: clock, needs, drives, moon cycle, cooldowns, shrine, open questionsprompt.mjs— words for the model, decision back outmodel.mjs— onefetch,.envloading, dry-run stand-insloop.mjs— observe → decide → act → broadcast, on a timerserver.mjs—node:http, SSE, visitor routes, persistence tostate/public/— Three.js scene + panel, no build step
State (state/world.json, memory.json, diary.md) persists across restarts and is gitignored.