Something went wrong. Try again.
a tiny pet with an even tinier brain, living in your browser forked from do.llth.ing/tokenling
Something went wrong. Try again.
Files
- Python 54%
- Rust 22%
- TypeScript 15%
- HTML 5%
- JavaScript 2%
- 1 more language 2%
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…