whatisgithub

What is j-wash?

extraltodeus/j-wash — explained in plain English

Analysis updated 2026-05-18

187PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A local tool that lets you inspect and edit how a large language model thinks, then export the edited model as a standalone checkpoint, no retraining needed.

Mindmap

mindmap
  root((J-Wash))
    What it does
      Live model inspection
      Token level edits
      Export standalone model
    Tech stack
      Python
      FastAPI
      React
      CUDA
    Use cases
      Change model identity
      Study model internals
      Export edited checkpoint
    Requirements
      NVIDIA GPU
      Python 3.11+
      Node.js 18+
    Audience
      Researchers
      ML engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Explore what a Hugging Face language model is paying attention to while it generates a reply.

USE CASE 2

Nudge a model's identity or behavior using small, targeted token edits instead of retraining.

USE CASE 3

Export an edited model as a standalone checkpoint that runs anywhere transformers models run.

USE CASE 4

Fit a custom Jacobian lens for a model that does not already have one on Neuronpedia.

What is it built with?

PythonFastAPIReactCUDADocker

How does it compare?

extraltodeus/j-washdjfksjd/ir-searchkorroai/onklaud-5
Stars187187186
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity5/52/53/5
Audienceresearcherpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires an NVIDIA GPU with CUDA, Python 3.11+, and Node.js 18+ to build and run.

So what is it?

J-Wash is a local tool for changing how a large language model talks and behaves, without retraining it on any data. It works with models downloaded from Hugging Face and gives you a browser based studio where you can chat with a model while watching a live view of what each layer of the model is paying attention to as it forms a reply. This live view is called a Jacobian lens, a method built by Anthropic that reads what each layer contributes to the model's thinking through the model's own vocabulary. While chatting, you can pin specific concepts the lens shows you and inspect how strongly they activate as the model writes each token. From there you can define simple, token level edits, for example nudging a model that says "I am a large language model" toward saying "I am a large language fish". These edits show up live in the chat so you can see the effect before committing to it. Once you are happy with an edit, J-Wash can export it as a real, standalone checkpoint: a full modified copy of the model, just the changed layers, or a LoRA adapter. All of these are saved in the standard safetensors format, so the edited model can be loaded and run anywhere the transformers library works, with no need for J-Wash itself to be present afterward. The project ships pre built lenses from Neuronpedia for common models, and also lets you fit your own lens locally if one does not already exist for the model you are using. It requires an NVIDIA GPU with CUDA, Python 3.11 or newer, and Node.js 18 or newer, and can be installed natively or run through Docker. There is also a command line interface for people who prefer not to use the browser UI. Conversations, edits, and presets are saved locally using SQLite, and past chats can be branched from any point in the conversation.

Copy-paste prompts

Prompt 1
Walk me through installing J-Wash natively with an NVIDIA GPU and Python 3.11.
Prompt 2
Explain how the Jacobian lens in J-Wash shows what each model layer is reading.
Prompt 3
Show me how to edit a model's token behavior in J-Wash and export it as a LoRA.
Prompt 4
Help me set up J-Wash with Docker and mount a persistent Hugging Face cache.

Frequently asked questions

What is j-wash?

A local tool that lets you inspect and edit how a large language model thinks, then export the edited model as a standalone checkpoint, no retraining needed.

What language is j-wash written in?

Mainly Python. The stack also includes Python, FastAPI, React.

How hard is j-wash to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is j-wash for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.