# START HERE

**xai** = **explainable AI**. Offline. No pip. Python ≥ 3.10 stdlib.

## open

1. [index.html](index.html)  
2. markdown under `studies/` · `dissertation/`  
3. public portal: [spaces/lyffseba/xai](https://huggingface.co/spaces/lyffseba/xai)

## prove it works

```
make test
# or
python3 studies/run.py test
```

→ `✓ test passed` (no network).

## study

| | path | why |
|---|---|---|
| Inkling | [studies/models/inkling/](studies/models/inkling/) | public weights + vendored transformers |
| Laguna S 2.1 | [studies/models/laguna-s-2.1/](studies/models/laguna-s-2.1/) | Poolside 118B-A8B · agentic coding · OpenMDW |
| Kimi K3 | [studies/models/kimi-k3/](studies/models/kimi-k3/) | live API + KDA; weights ~2026-07-27 |
| compare | [inkling-vs-kimi-k3](studies/shared/comparisons/inkling-vs-kimi-k3.md) · [tri](studies/shared/comparisons/laguna-s-vs-inkling-vs-kimi.md) | long-ctx / MoE bets |
| MSc | [dissertation/main.ipynb](dissertation/main.ipynb) | Concept Whitening |

## order (~1–2 days)

1. map — [STUDY.md](studies/STUDY.md) · [DASHBOARD](studies/derived/DASHBOARD.md) · [GLOSSARY](studies/shared/GLOSSARY.md)  
2. Inkling — book `00` → SPEC → arch → `modular_inkling.py`  
3. Laguna S 2.1 — book `00` → SPEC → layer schedule → serve/thinking  
4. Kimi K3 — book `00` → SPEC → lineage → KDA → API → limits  
5. compare again (pair + tri)  
6. dissertation when data is ready  

## facts (do not invent)

- **Inkling:** ~975B / 41B · 6/256+2 · relative PE · SWA/global · image+audio · 1M  
- **Laguna S 2.1:** 118B / 8B · 10/256+1 (shared **add**) · sigmoid router · softplus attn gate · 12G/36SWA · YaRN · 1M · OpenMDW-1.1 · chat `<think>` / `<tool_call>`  

- **Kimi K3:** 2.8T · 16/896 · KDA+AttnRes · vision/video · 1M · active undisclosed · weights ETA 2026-07-27  

## offline vs online

| offline | online |
|---|---|
| `make test` / `make check` | `make refresh MODEL=…` |
| read `reference/` | Hub / blog re-fetch |

[OFFLINE.md](OFFLINE.md) · mirrors: `make sync`