README.md

metadata

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
This UI + Windows/Linux/CUDA port by Gregor Koch — 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

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)
• Gradio UI + cross-platform port: Gregor Koch (@cronos3k)
• License: Apache-2.0