a tiny pet with an even tinier brain, living in your browser forked from do.llth.ing/tokenling
README.md
# subtokenling **subtokenling**, a language-model pet that can live on your device or a trusted server. A small Tamagotchi-like creature whose brain is a fully fine-tuned [GPT-2](https://huggingface.co/openai-community/gpt2) (the original 124M model). The brain makes the decisions: it chats, toddles around its room, reacts to pats, decides whether it wants the snack, bath, medicine or game of catch you offer, wants things, naps and dreams, remembers things about you and writes a diary page at bedtime. The page only runs its body (hunger, energy, mess) and its room. It grows from baby to kid, teen and adult in real time. In local mode, there's no server or API: the egg hatches once the page has downloaded the brain (about 97 MB, 4-bit) into the browser's Cache Storage, and it runs on the visitor's device with transformers.js on WebAssembly. The pet, its chat, memories, gifts and diary live in `localStorage`. It installs as an app, works offline, and can send alerts the owner turns on (no push server: the page plans them and its service worker shows them). New brains are offered as an upgrade; compatible older brains can stay in use. After a prompt-format change the pet dozes until its new brain is downloaded, keeping its save. Choose local or remote when you get an egg, and switch either way later in settings. The optional [Rust host](server/README.md) stores a remote pet’s private save and runs its body and brain while the browser is closed. The browser keeps a recovery checkpoint. Transfers preserve memories, gifts, chat, diary and birth time. Remote mode shares that data with the chosen host, so choose one you trust. Private access keys come first; ATProto sign-in and multiplayer are later work. Private smaller-brain experiments now train genuine GPT-2/Pythia warm starts and a standard Llama scratch candidate, with strict masks, browser-aligned behavioral evaluation and actual q4/q8/fp32 exports. No replacement is selected or published; the inherited model remains the baseline. Explicit family/cache contra…