README.md

---
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