Interactive Lab

Interactive Lab

BitForge includes a static web dashboard in site/ for exploring quantization concepts and simulating trade-offs—no Python server or build step required.

Launch locally

Option A — open directly:

open site/index.html   # macOS
xdg-open site/index.html   # Linux

Option B — local HTTP server (recommended for fetch/CDN consistency):

cd site
python -m http.server 8080

Then visit http://localhost:8080.

What's inside

The dashboard (index.html + app.js) includes:

Section	Content
Overview	Project mission and navigation hub
Taxonomy	PTQ vs QAT vs hybrid; method comparison tabs
Simulator	Interactive charts: bit width vs perplexity, VRAM, tokens/sec
Outlier lab	Visual demo of activation spikes and suppression
Reference	KaTeX-rendered formulas and method summaries

Built with:

• Tailwind CSS (CDN)
• Chart.js for trade-off charts
• KaTeX for math rendering
• Font Awesome icons

Simulator behavior

The bit-width simulator uses client-side mock curves to illustrate trends:

• Lower bit width → higher perplexity (quality loss)
• Lower bit width → lower VRAM and higher tokens/sec

These curves are educational, not live benchmark results. For real numbers, run Experiments or bitforge evaluate.

Relationship to the library

site/ (browser UI, mock/educational data)
  │
  └── illustrates concepts documented in Quantization Theory
  │
bitforge/ + experiments/ (Python, real measurements)

Future work may connect the dashboard to exported JSON from QuantizationBenchmarkSuite for live data overlays.

Customization

• Edit site/app.js for chart parameters and simulator logic
• Edit site/index.html for layout and copy
• Colors and typography are defined in the Tailwind config block at the top of index.html (bf-accent, bf-bg, etc.)

No bundler—changes are visible on browser refresh.

Offline use

The page loads Tailwind, Chart.js, KaTeX, and Font Awesome from CDNs. Full offline use requires caching those assets locally or swapping CDN URLs to vendored copies.