neuron-lens.com shows what each neuron and attention head inside two open
language models, Qwen3-8B and Gemma 4 12B, responds to and what it makes the model say: the words and
ideas that set it off, the examples where it fired hardest, what pushing it promotes, and, for Gemma 4,
the images and sounds it responds to. Every unit has an address (/qwen3-8b/L8/n344,
/gemma-4-12b/L35/h14).
The readings come from the neuron-lens analysis (weight lenses, top firings, steering checks), with labels by Claude Haiku 5.5.
Node 24 or newer.
npm ci
npm run dev # http://localhost:5180
npm run check # svelte-check
npm run test:e2e # Playwright, on a small mock catalog
npm run build # dist/The site is a static single-page app: Vite, Svelte 5 and TypeScript, no server code.
The explorer reads a prebuilt catalog of static JSON (and, for Gemma 4, packs of images and sounds):
on the site from data.neuron-lens.com (Cloudflare R2), in development from catalog/, which the dev
server serves at /data. It is several gigabytes and not in the repository: scripts/neurons/ builds
it from the neuron-lens catalogs, and scripts/catalog/upload.sh puts it on R2 (see AGENTS.md, "The
catalog"). Without it the dev server shows the explorer's shell and an error where the data goes, unless
it is started with VITE_CATALOG=live to read the live catalog; the e2e tests bring their own mock catalog
(e2e/fixtures).
scripts/deploy.sh builds from a clean, pushed main whose catalog builds (named in
src/lib/catalog.json) are already on R2, uploads dist to Cloudflare Pages with Wrangler, and checks
the live site with scripts/verify-deployment.mjs. A new catalog goes up first, with
scripts/catalog/upload.sh <model>. It
needs CLOUDFLARE_ACCOUNT_ID (in the environment or ~/.config/cloudflare/neuron-lens.env) and signs
in with CLOUDFLARE_API_TOKEN if set, else with wrangler login; --dry-run stops before the upload.
By a9lim, treetown and Claude. Images and sounds are shown under their collections' licences, listed
on the site's Credits page. The design is Ledger (stdlogits/ledger),
whose Wix Madefor faces are under the SIL Open Font License.