File size: 2,528 Bytes
3d5c035
 
45d8b0a
 
3d5c035
 
 
45d8b0a
 
3d5c035
 
45d8b0a
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
89d20a8
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
45d8b0a
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
---
title: LARQL Explorer
emoji: 🧠
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
license: apache-2.0
short_description: Query neural network weights like a knowledge graph
---

# LARQL Explorer

**The model IS the database.** Browse transformer weight space as a knowledge graph —
no terminal, no LQL syntax needed.

Original LARQL system by **Chris Hayuk** — [chrishayuk/larql](https://github.com/chrishayuk/larql)  
This UI + Windows/Linux/CUDA port by **Gregor Koch** — [cronos3k/larql](https://github.com/cronos3k/larql)

> The original was a command-line tool for macOS only.
> This fork opens it up: any platform, any hardware, any browser.

## Features

| Tab | What it does |
|---|---|
| 🔍 Walk Explorer | See which FFN features fire for any prompt, layer by layer |
| 🧪 Knowledge Probe | Compare three prompts side-by-side at the same layer |
| 💻 LQL Console | Full LQL query interface with example buttons |
| 📊 Vindex Info | Model metadata + SHA256 checksum verification |
| ⬇️ Extract | Download + extract a model from HuggingFace Hub |
| ℹ️ Setup | Build instructions and environment info |

## Running locally

```bash
git clone https://github.com/cronos3k/larql
cd larql
cargo build --release          # or --features cuda for NVIDIA GPU
pip install -r demo/requirements.txt
python demo/app.py
```

## Known Issues

### Tab navigation stops working after running Walk Explorer

**What happens:** After running a query in the Walk Explorer tab and results appear
in the feature table, clicking other tabs (Knowledge Probe, LQL Console, etc.) may
silently fail — the tab appears not to switch.

**Root cause:** Gradio 6.12 bug. A `TypeError` in the internal Dataframe component
(`Index-BGETwOir.js: Cannot read properties of undefined (reading '0')`) fires during
the Svelte reactive re-render triggered by the tab switch. The error is swallowed
silently, leaving the UI stuck on Walk Explorer.

**Workaround:** Refresh the page (F5 / ⌘R) and navigate to the desired tab
*before* running Walk. All tabs function correctly on a fresh page load.
The bug only appears after Walk results populate the feature table.

**Affected version:** Gradio 6.12.0 (pinned in `requirements.txt`).
Upgrading Gradio may resolve it once the upstream issue is fixed.

## Credits

- **LARQL / LQL / vindex format:** Chris Hayuk ([@chrishayuk](https://github.com/chrishayuk))
- **Gradio UI + cross-platform port:** Gregor Koch ([@cronos3k](https://github.com/cronos3k))
- License: Apache-2.0