# kp759/unlearning architecture

> Architecture diagram of the GitHub repository kp759/unlearning, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kp759/unlearning
- Repository: https://github.com/kp759/unlearning

## Overview

This repository is a collection of language-model unlearning and editing research code, evaluation frameworks, and experimental methods. Its principal workflow is to prepare forget/retain requests, compute an edit or unlearning update, apply it to a model, and evaluate forgetting alongside retained utility. The graph preserves the documented-by-source ZeroUnlearn, ECO, and open-unlearning branches. The README is empty, and many modules were not sampled, so uncertain runtime links are omitted rather than inferred.

Main entry points: [`ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py) (ZeroUnlearn update), [`ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py) (Gradient update), [`ZeroUnlearn/util/nethook.py`](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/nethook.py) (Model hooks), [`open-unlearning/src/train.py`](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/open-unlearning/src/train.py) (Training entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_methods["Editing methods"]
  node_zero_main["ZeroUnlearn update"]
  node_zero_compute["Update vectors<br/>[compute_z.py]"]
  node_zero_hparams["ZeroUnlearn config"]
  node_gd_main["Gradient update"]
  node_gd_compute["Gradient vectors<br/>[compute_z.py]"]
  node_gd_config["Gradient config"]
  node_embhead["Embedding-head edit"]
  node_alpha["AlphaEdit<br/>[AlphaEdit_main.py]"]
  node_memit["MEMIT edit<br/>[memit_rect_main.py]"]
  node_baselines["Unlearning baselines"]
end

subgraph group_data["Datasets and evaluation"]
  node_datasets["Edit datasets"]
  node_tfidf["TF-IDF statistics<br/>[tfidf_stats.py]"]
  node_experiment_eval["Edit evaluation<br/>[evaluate.py]"]
  node_glue["Task evaluations"]
end

subgraph group_shared["Model utilities"]
  node_repr["Representation extraction<br/>[repr_tools.py]"]
  node_stats["Layer statistics<br/>[layer_stats.py]"]
  node_retain_stats["Retain statistics"]
  node_tokens["Token dataset<br/>[tok_dataset.py]"]
  node_hooks["Model hooks<br/>[nethook.py]"]
  node_generation["Text generation<br/>[generate.py]"]
  node_running["Running statistics<br/>[runningstats.py]"]
end

subgraph group_eco["ECO evaluation"]
  node_eco_engine["Inference engines<br/>[inference.py]"]
  node_eco_data["Benchmark datasets"]
  node_eco_evaluators["Metric evaluators"]
  node_eco_attack["Attack utilities<br/>[utils.py]"]
  node_eco_model["Model wrapper<br/>[model.py]"]
end

subgraph group_open["Open unlearning"]
  node_open_train["Training entry point<br/>[train.py]"]
  node_open_data["Training data"]
  node_open_trainer["Unlearning trainers"]
  node_open_eval["Unlearning evaluation"]
end

node_user(("Researcher"))

node_user -->|"runs evaluation"| node_experiment_eval
node_zero_main -->|"computes vectors"| node_zero_compute
node_zero_main -->|"uses settings"| node_zero_hparams
node_zero_main -->|"loads statistics"| node_stats
node_zero_main -->|"loads retain statistics"| node_retain_stats
node_zero_main -->|"uses token data"| node_tokens
node_zero_main -->|"hooks model"| node_hooks
node_zero_main -->|"generates contexts"| node_generation
node_zero_main -->|"accumulates statistics"| node_running
node_gd_main -->|"computes vectors"| node_gd_compute
node_gd_main -->|"uses settings"| node_gd_config
node_gd_main -->|"loads statistics"| node_stats
node_gd_main -->|"loads retain statistics"| node_retain_stats
node_gd_main -->|"uses token data"| node_tokens
node_gd_main -->|"hooks model"| node_hooks
node_gd_main -->|"generates contexts"| node_generation
node_gd_main -->|"accumulates statistics"| node_running
node_zero_compute -->|"extracts representations"| node_repr
node_zero_compute -->|"hooks model"| node_hooks
node_gd_compute -->|"extracts representations"| node_repr
node_gd_compute -->|"hooks model"| node_hooks
node_embhead -.->|"hooks model"| node_hooks
node_alpha -->|"extracts representations"| node_repr
node_alpha -->|"hooks model"| node_hooks
node_memit -->|"reads parameters"| node_hooks
node_memit -->|"generates contexts"| node_generation
node_experiment_eval -->|"loads datasets"| node_datasets
node_experiment_eval -->|"runs task evaluation"| node_glue
node_datasets -->|"uses TF-IDF"| node_tfidf
node_tfidf -->|"reads snippets"| node_datasets
node_eco_engine -->|"removes hooks"| node_eco_attack
node_open_train -->|"loads data"| node_open_data
node_open_train -->|"configures trainer"| node_open_trainer
node_open_train -->|"configures evaluation"| node_open_eval
node_open_train -->|"uses model"| node_eco_model

click node_zero_main "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py"
click node_zero_compute "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/compute_z.py"
click node_zero_hparams "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_hparams.py"
click node_gd_main "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py"
click node_gd_compute "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/compute_z.py"
click node_gd_config "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_hparams.py"
click node_embhead "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_EmbHead/ZeroUnlearn_EmbHead_main.py"
click node_alpha "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/AlphaEdit/AlphaEdit_main.py"
click node_memit "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/memit/memit_rect_main.py"
click node_baselines "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/ZeroUnlearn/baselines"
click node_datasets "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/ZeroUnlearn/dsets"
click node_tfidf "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/dsets/tfidf_stats.py"
click node_experiment_eval "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/experiments/evaluate.py"
click node_glue "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/ZeroUnlearn/glue_eval"
click node_repr "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/repr_tools.py"
click node_stats "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/layer_stats.py"
click node_retain_stats "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/layer_stats_retain.py"
click node_tokens "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/tok_dataset.py"
click node_hooks "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/nethook.py"
click node_generation "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/generate.py"
click node_running "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/runningstats.py"
click node_eco_engine "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/eco/eco/inference.py"
click node_eco_data "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/eco/eco/dataset"
click node_eco_evaluators "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/eco/eco/evaluator"
click node_eco_attack "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/eco/eco/attack/utils.py"
click node_open_train "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/open-unlearning/src/train.py"
click node_open_data "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/open-unlearning/src/data"
click node_open_trainer "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/open-unlearning/src/trainer"
click node_open_eval "https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/open-unlearning/src/evals"
click node_eco_model "https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/eco/eco/model/model.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_zero_main,node_zero_compute,node_zero_hparams,node_gd_main,node_gd_compute,node_gd_config,node_embhead,node_alpha,node_memit,node_baselines toneBlue
class node_datasets,node_tfidf,node_experiment_eval,node_glue toneAmber
class node_repr,node_stats,node_retain_stats,node_tokens,node_hooks,node_generation,node_running toneMint
class node_eco_engine,node_eco_data,node_eco_evaluators,node_eco_attack,node_eco_model toneRose
class node_open_train,node_open_data,node_open_trainer,node_open_eval,node_user toneIndigo
```

## Components

### Editing methods

- [ZeroUnlearn update](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py): `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`
- [Update vectors](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/compute_z.py): `ZeroUnlearn/ZeroUnlearn/compute_z.py`
- [ZeroUnlearn config](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_hparams.py): `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_hparams.py`
- [Gradient update](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py): `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`
- [Gradient vectors](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/compute_z.py): `ZeroUnlearn/ZeroUnlearn_GD/compute_z.py`
- [Gradient config](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_hparams.py): `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_hparams.py`
- [Embedding-head edit](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/ZeroUnlearn_EmbHead/ZeroUnlearn_EmbHead_main.py): `ZeroUnlearn/ZeroUnlearn_EmbHead/ZeroUnlearn_EmbHead_main.py`
- [AlphaEdit](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/AlphaEdit/AlphaEdit_main.py): `ZeroUnlearn/AlphaEdit/AlphaEdit_main.py`
- [MEMIT edit](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/memit/memit_rect_main.py): `ZeroUnlearn/memit/memit_rect_main.py`
- [Unlearning baselines](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/ZeroUnlearn/baselines): `ZeroUnlearn/baselines`

### Datasets and evaluation

- [Edit datasets](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/ZeroUnlearn/dsets): `ZeroUnlearn/dsets`
- [TF-IDF statistics](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/dsets/tfidf_stats.py): `ZeroUnlearn/dsets/tfidf_stats.py`
- [Edit evaluation](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/experiments/evaluate.py): `ZeroUnlearn/experiments/evaluate.py`
- [Task evaluations](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/ZeroUnlearn/glue_eval): `ZeroUnlearn/glue_eval`

### Model utilities

- [Representation extraction](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/repr_tools.py): `ZeroUnlearn/rome/repr_tools.py`
- [Layer statistics](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/layer_stats.py): `ZeroUnlearn/rome/layer_stats.py`
- [Retain statistics](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/layer_stats_retain.py): `ZeroUnlearn/rome/layer_stats_retain.py`
- [Token dataset](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/rome/tok_dataset.py): `ZeroUnlearn/rome/tok_dataset.py`
- [Model hooks](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/nethook.py): `ZeroUnlearn/util/nethook.py`
- [Text generation](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/generate.py): `ZeroUnlearn/util/generate.py`
- [Running statistics](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/ZeroUnlearn/util/runningstats.py): `ZeroUnlearn/util/runningstats.py`

### ECO evaluation

- [Inference engines](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/eco/eco/inference.py): `eco/eco/inference.py`
- [Benchmark datasets](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/eco/eco/dataset): `eco/eco/dataset`
- [Metric evaluators](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/eco/eco/evaluator): `eco/eco/evaluator`
- [Attack utilities](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/eco/eco/attack/utils.py): `eco/eco/attack/utils.py`
- [Model wrapper](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/eco/eco/model/model.py): `eco/eco/model/model.py`

### Open unlearning

- [Training entry point](https://github.com/kp759/unlearning/blob/claude/setup-project-structure-JQ7fN/open-unlearning/src/train.py): `open-unlearning/src/train.py`
- [Training data](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/open-unlearning/src/data): `open-unlearning/src/data`
- [Unlearning trainers](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/open-unlearning/src/trainer): `open-unlearning/src/trainer`
- [Unlearning evaluation](https://github.com/kp759/unlearning/tree/claude/setup-project-structure-JQ7fN/open-unlearning/src/evals): `open-unlearning/src/evals`

### Other components

- **Researcher**

## Connections

- Researcher → Edit evaluation: runs evaluation (evidence: `ZeroUnlearn/experiments/evaluate.py`)
- ZeroUnlearn update → Update vectors: computes vectors (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → ZeroUnlearn config: uses settings (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → Layer statistics: loads statistics (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → Retain statistics: loads retain statistics (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → Token dataset: uses token data (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → Model hooks: hooks model (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → Text generation: generates contexts (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- ZeroUnlearn update → Running statistics: accumulates statistics (evidence: `ZeroUnlearn/ZeroUnlearn/ZeroUnlearn_main.py`)
- Gradient update → Gradient vectors: computes vectors (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Gradient config: uses settings (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Layer statistics: loads statistics (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Retain statistics: loads retain statistics (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Token dataset: uses token data (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Model hooks: hooks model (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Text generation: generates contexts (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Gradient update → Running statistics: accumulates statistics (evidence: `ZeroUnlearn/ZeroUnlearn_GD/ZeroUnlearnGD_main.py`)
- Update vectors → Representation extraction: extracts representations (evidence: `ZeroUnlearn/ZeroUnlearn/compute_z.py`)
- Update vectors → Model hooks: hooks model (evidence: `ZeroUnlearn/ZeroUnlearn/compute_z.py`)
- Gradient vectors → Representation extraction: extracts representations (evidence: `ZeroUnlearn/ZeroUnlearn_GD/compute_z.py`)
- Gradient vectors → Model hooks: hooks model (evidence: `ZeroUnlearn/ZeroUnlearn_GD/compute_z.py`)
- Embedding-head edit → Model hooks: hooks model
- AlphaEdit → Representation extraction: extracts representations
- AlphaEdit → Model hooks: hooks model
- MEMIT edit → Model hooks: reads parameters (evidence: `ZeroUnlearn/memit/memit_rect_main.py`)
- MEMIT edit → Text generation: generates contexts (evidence: `ZeroUnlearn/memit/memit_rect_main.py`)
- Edit evaluation → Edit datasets: loads datasets (evidence: `ZeroUnlearn/experiments/evaluate.py`)
- Edit evaluation → Task evaluations: runs task evaluation (evidence: `ZeroUnlearn/experiments/evaluate.py`)
- Edit datasets → TF-IDF statistics: uses TF-IDF (evidence: `ZeroUnlearn/dsets/tfidf_stats.py`)
- TF-IDF statistics → Edit datasets: reads snippets (evidence: `ZeroUnlearn/dsets/tfidf_stats.py`)
- Inference engines → Attack utilities: removes hooks (evidence: `eco/eco/inference.py`)
- Training entry point → Training data: loads data (evidence: `open-unlearning/src/train.py`)
- Training entry point → Unlearning trainers: configures trainer (evidence: `open-unlearning/src/train.py`)
- Training entry point → Unlearning evaluation: configures evaluation (evidence: `open-unlearning/src/train.py`)
- Training entry point → Model wrapper: uses model (evidence: `open-unlearning/src/train.py`)
