How to: Smoke Test Workflow
Trigger the **🔥 Smoke Test** job from the GitHub Actions tab to run linting,
unit tests and a short 2‑year simulation in offline mode. The workflow verifies
the ledger output and catches import errors or circular dependencies early.

**Important:** Run `npm run fetch-assets` before `npm install` or executing
`./setup.sh` to download the browser demo assets. Run this command in a fresh
checkout—or delete existing `wasm*/` files first—so placeholder files are
replaced. After the download, verify checksums with
`python scripts/fetch_assets.py --verify-only`. The helper retrieves the
official Pyodide runtime from the jsDelivr CDN and the GPT‑2 small checkpoint
directly from the Hugging Face CDN. The legacy `wasm-gpt2.tar` bundle is no longer used.
Override `HF_GPT2_BASE_URL`
to change the mirror, for example:

```bash
export HF_GPT2_BASE_URL="https://huggingface.co/openai-community/gpt2/resolve/main"
```

If `npm run fetch-assets` fails with a 401 or 404 error, download the GPT‑2
files manually:
```bash
python scripts/download_hf_gpt2.py models/gpt2
```
Each file can also be fetched individually using these official links:
```bash
curl -O https://huggingface.co/openai-community/gpt2/resolve/main/pytorch_model.bin
curl -O https://huggingface.co/openai-community/gpt2/resolve/main/vocab.json
curl -O https://huggingface.co/openai-community/gpt2/resolve/main/merges.txt
curl -O https://huggingface.co/openai-community/gpt2/resolve/main/config.json
```
The model weights have SHA‑256
`7c5d3f4b8b76583b422fcb9189ad6c89d5d97a094541ce8932dce3ecabde1421` for
verification. See
[insight_browser_v1/index.md](alpha_factory_v1/demos/alpha_agi_insight_v1/insight_browser_v1/index.md)
for additional details.

[![Launch \u03b1\u2011AGI Insight](https://img.shields.io/badge/Launch-%CE%B1%E2%80%91AGI%20Insight-blue?style=for-the-badge)](https://montrealai.github.io/AGI-Alpha-Agent-v0/alpha_agi_insight_v1/)