Skip to content
View moudrkat's full-sized avatar

Block or report moudrkat

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please donโ€™t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
moudrkat/README.md

Hey, I'm Kate ๐Ÿ‘‹

AI Engineer โ€ข Former Particle Physicist โš›๏ธ โ€ข Former Risk Modeler ๐Ÿ“ˆ

I've spent my whole career looking inside systems that would rather stay opaque โ€” first particle collisions, then risk models, now neural networks.

The models talk to us all day. I want to be able to affect them back.

And I want to shove AI into the device and look inside it: edge AI and interpretability, together.

Why I'm really doing this โ†’ the manifesto

Three ways in:

you want to go to
๐Ÿ”ฌ see inside a model: watch it think, find out why it did that, fix it the interpretability lab
๐Ÿ”ฉ run a model on the device: in a phone, or on a chip that costs less than lunch edge AI
๐ŸŽˆ just play with something: mostly small models doing odd jobs in a browser tab the cabinet of drawers

Five minutes, no account, no chip:

pip install brainscope && brainscope --model tiny        # watch a model think, in your browser
git clone https://github.com/moudrkat/maxwell-on-a-chip && cd maxwell-on-a-chip
cc -O2 -o host/maxwell host/maxwell.c -lm && host/maxwell 28    # Maxwell and Boltzmann at 28 ยฐC

๐Ÿ’ฅ Come say hi in my collision chamber

My personal site is a chat with a tiny LLM running entirely in your browser, and every answer it generates renders as a real particle collision. Click the event below to fire your own question into the chamber:

One question fired into the chamber: the model answers while its layers, attention heads and logit-lens flips render as a real collision.


๐Ÿš€ An open-source interpretability lab, tested on a real production app

Watch a model think (brainscope, probascope) โ†’ diagnose why it did that โ†’ fix it at the source (hidden-directions โ†’ hotwire-vllm). Observability first; intervention last, once the instruments have earned it.

Tip

Don't read, just do it. pip install brainscope, then brainscope --model tiny: a browser view of a model thinking. CPU is fine. No account, no course.

Click any box to open its repo.

flowchart TD
    hd["๐Ÿงญ <b>hidden-directions</b><br/>behavior โ†’ vector"]
    bs(["๐Ÿง  <b>brainscope</b><br/>watch a model think<br/>(on your running app)"])
    ps(["๐Ÿ“ฑ <b>probascope</b><br/>watch a model think<br/>(inside your phone)"])
    st["๐Ÿ•น๏ธ <b>steeropathy</b><br/>agents talking through activations"]
    tm["โš–๏ธ <b>in-two-minds</b><br/>agent hesitating between tools"]
    hw["๐Ÿ”ฅ <b>hotwire-vllm</b><br/>steering in production vLLM"]
    sm["๐Ÿงช <b>steering-mechanics</b><br/>how steering actually works"]
    on["๐Ÿ“ฐ <b>old-news</b><br/>stale history outranking<br/>your system prompt"]
    kj["๐Ÿฆต <b>kneejerk</b><br/>decision models as a library<br/>(llama.cpp, no server)"]
    hi["๐ŸŽฏ <b>hidden-intent</b><br/>a probe that reads intent<br/>before the first line"]

    hd -->|"vectors"| bs
    bs -->|"hosts & captures"| st
    bs -->|"hosts & captures"| tm
    st -.->|"steers with"| hd
    hd -->|"vector + passport"| hw
    bs <-.->|"same spec: lab โ†” prod"| hw
    bs -->|"causal replay"| sm
    hw -.->|"vector under study"| sm
    bs -->|"hosts & captures"| on
    bs <-.->|"the lens: server โ†” phone"| ps
    kj -->|"model inside the app"| ps
    hi -->|"probe"| bs

    click hd "https://github.com/moudrkat/hidden-directions"
    click bs "https://github.com/moudrkat/brainscope"
    click st "https://github.com/moudrkat/steeropathy"
    click tm "https://github.com/moudrkat/in-two-minds"
    click hw "https://github.com/moudrkat/hotwire-vllm"
    click sm "https://github.com/moudrkat/steering-mechanics"
    click on "https://github.com/moudrkat/old-news"
    click kj "https://github.com/moudrkat/kneejerk"
    click ps "https://github.com/moudrkat/probascope"
    click hi "https://github.com/moudrkat/hidden-intent"

    classDef engine fill:#1f6feb,stroke:#1158c7,color:#ffffff;
    classDef exp fill:#8957e5,stroke:#6e40c9,color:#ffffff;
    class bs,ps,hd,hw,kj engine;
    class st,tm,sm,on,hi exp;
Loading

๐Ÿ”ฉ Shoved into the device: edge AI

Research that only runs behind a server isn't finished. These take it the last mile, natively. No cloud, no account, nothing phones home.

๐Ÿ“ฑ In a phone

  • ๐Ÿฆต kneejerk โ€” decision models as a library on llama.cpp: no server, one forward pass, built for a phone app.
  • ๐Ÿ“ฑ probascope โ€” an Android app: a decision model runs in the phone, and you drag over its layers to see where the answer formed.
  • ๐Ÿงญ decide-me โ€” point your phone at the world and a decision model inside it tells you what to do next. I said I would not build this.

๐Ÿ”Œ Inference on a chip

An ESP32-S3: 16 MB of flash, a few dollars, no operating system. Models of 3โ€“4 million parameters, trained from scratch, running on it.

  • โœ๏ธ esp32-ai โ€” you type a sentence, a 3M-parameter model inside the chip writes a small program for its own screen, and the chip runs it. Built on slvDev/esp32-ai.
  • ๐ŸŒก๏ธ maxwell-on-a-chip โ€” a tiny model of Maxwell and Boltzmann, sampled with their own distribution, at the temperature of the room. Maxwell's demon is on the BOOT button.

๐Ÿค Where the two meet

Small models on small devices are the ones you can actually open up: probascope is the lens in a pocket, and hotwire-vllm is the same last-mile move for steering, in production vLLM.


๐Ÿค What I'm looking for

Collaborators and users. Build on LLMs and want to see inside your model? pip install, try it, and open an issue where it breaks.

What would you use it for? โ†’ tell-me: my guesses, and questions for you


๐ŸŽˆ Just for fun: a cabinet of drawers

Smaller things, and things that got out of hand. Pull any handle.

ย โ”โ”โ”ย ย  ๐ŸŒ In a browser tab โ€” what a small model can do with no server behind it
  • ๐ŸŒ brave-new-world โ€” a very small language model, in your browser tab, designs the entire page you are looking at.
  • ๐Ÿ’ฅ detektor โ€” the collision chamber above, open source.
  • ๐Ÿ”ฆ tournament-watermarking โ€” the watermark Anthropic now puts in Claude's output, running live as a decaying newspaper.
  • ๐ŸŽจ personal-rembrandt โ€” you can't build a personal brand, so build a personal Rembrandt: GPT-2 reads your bio and repaints his self-portrait.
  • ๐Ÿ”ฅ fouriers-fire โ€” a campfire from the equations up, and a sentence model whose words become the embers.
  • ๐Ÿ“œ paper-remembers โ€” Hopfield's 1982 paper, running live: rub out any part of the page and watch it rebuild itself.
  • ๐ŸŒง๏ธ coalescence โ€” a raindrop landing on a wet window: the thin-film equation, solved in your browser.
ย โ”โ”โ”ย ย  ๐Ÿ”ฌ Also on the bench โ€” smaller, self-contained ways to look inside
  • ๐ŸŽญ sixteen-voices โ€” how a tiny transformer encodes writing style.
  • ๐Ÿ‘๏ธ show-me-your-attention โ€” attention maps and neuron activations over your own prompt.
  • ๐Ÿ–ผ๏ธ jepa-demo โ€” I-JEPA & V-JEPA 2 hands-on, no GPU needed.
  • ๐Ÿ„ Mushroom-generator โ€” a VAE growing mushrooms, its decoder taken apart layer by layer.
  • ๐ŸŽ Applepear โ€” apples vs pears in a tiny CNN, grad-CAM included.
  • โš™๏ธ Minimize_me โ€” race TensorFlow optimizers across loss landscapes.
ย โ”โ”โ”ย ย  ๐Ÿƒ And off the bench โ€” everything else that got out of hand
  • ๐ŸŒ™ tri-kumpani โ€” Li Po's Drinking Alone under the Moon, read by a small Chinese model twelve hundred years later. โ–ถ open it
  • ๐Ÿšช resi-doom โ€” Doom, except the level is a language model mid-sentence. W and S. That is the control scheme. โ–ถ open it
  • ๐ŸŽธ unlived โ€” a gamebook of the life you never lived. You win by quitting the game to go live it.
  • ๐ŸŽ‰ promptparty โ€” a dashboard for friends agent-coding in one room: when to ๐Ÿ—ฃ๏ธ TALK and when to โŒจ๏ธ PROMPT.
  • ๐Ÿ›๏ธ go-to-damn-bed โ€” a Claude Code skill that sends you to bed. It counts to three. It never says what happens at three.
  • ๐Ÿ‘‘ KingOfDiamonds โ€” the King of Diamonds game from Alice in Borderland, played by LLMs in character.
  • ๐Ÿ—จ๏ธ paralel-discordverse โ€” your company's Discord gets a parallel universe of fictional colleagues.
  • ๐Ÿง… underglaze โ€” the blue tile on a kitchen wall, as a sum of cosines. The pattern everyone here calls cibulรกk turns out to have no onion in it.
  • ๐Ÿงฎ least-squares-method โ€” code archaeology: a printed Pascal listing, photographed page by page and revived on Turbo Pascal 5.5.

None of it is perfect. That's kind of delightful.

Pinned Loading

  1. brainscope brainscope Public

    OpenAI-compatible server with a live view into any HF model's residual stream. pip install brainscope

    Python 54 11

  2. hotwire-vllm hotwire-vllm Public

    CUDA-graph-safe per-request activation steering plugin for vLLM. pip install hotwire-vllm

    Python 3 1

  3. steeropathy steeropathy Public

    Agents that talk through model internals โ€” activations & J-space โ€” instead of text. No words pass between them. The lab on top of brainscope + hidden-directions.

    Python 29 3

  4. probascope probascope Public

    Jev-like decision models running natively on your Android phone, with a look inside: where in the layers the answer formed, and the blocks your text went through

    Vue 4

  5. esp32-ai esp32-ai Public

    Forked from slvDev/esp32-ai

    A 3M-parameter model on an ESP32-S3 turns your sentence into a small program, and the same chip runs it. No cloud. Fork of slvDev/esp32-ai.

    Python 17 3

  6. maxwell-on-a-chip maxwell-on-a-chip Public

    A tiny model of Maxwell and Boltzmann, sampled with their own distribution, at the temperature of the room

    C