docs/notebook.md

Notebook Usage

Notebook path:

• notebooks/hf_space_demo.ipynb

Purpose

Short smoke test for:

• Colab GPU
• Kaggle GPU
• quick local validation

What Notebook Does

1. Install runtime deps.
2. Set conservative env vars.
3. Import project pipeline.
4. Run one short attribution job.
5. Print answer, runtime metadata, top edges.
6. Render heatmap.

Best Use

• validate model availability
• validate driver / torch / transformers stack
• sanity-check latency before public deploy

If Notebook Fails

Check:

• GPU available
• model access permissions
• enough VRAM
• eager attention enabled
• trace limits not too high