# xai

**xai** = **explainable AI**.

Personal offline monorepo: study notes on frontier open models + an MSc on interpretable vision.  
Source-driven. Stdlib validation. No pip. No network required to read or test.

| | |
|---|---|
| start | [START_HERE.md](START_HERE.md) · [index.html](index.html) |
| GitHub | [lyffseba/xai](https://github.com/lyffseba/xai) (canonical) |
| portal | [spaces/lyffseba/xai](https://huggingface.co/spaces/lyffseba/xai) |
| dataset | [datasets/lyffseba/xai-studies](https://huggingface.co/datasets/lyffseba/xai-studies) |

## what is here

| id | package | status | total | active | ctx | experts |
|---|---|---|---|---|---|---|
| inkling | [studies/models/inkling](studies/models/inkling/) | weights public | 975B | 41B | 1M | 6/256+2 |
| kimi-k3 | [studies/models/kimi-k3](studies/models/kimi-k3/) | API live · weights pending | 2.8T | undisclosed | 1M | 16/896 |
| laguna-s-2.1 | [studies/models/laguna-s-2.1](studies/models/laguna-s-2.1/) | weights public | 118B | 8B | 1M | 10/256+1 |

[compare](studies/shared/comparisons/inkling-vs-kimi-k3.md) · [Laguna vs both](studies/shared/comparisons/laguna-s-vs-inkling-vs-kimi.md) · [dashboard](studies/derived/DASHBOARD.md) · [glossary](studies/shared/GLOSSARY.md)

**MSc** — [dissertation/](dissertation/) vinyl-cover genre (CNN + Concept Whitening) · [main.ipynb](dissertation/main.ipynb)

## quick start

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

Expect `✓ test passed`. Then [START_HERE.md](START_HERE.md).

**Mirrors** (after `make sync`): GitHub · [Space](https://huggingface.co/spaces/lyffseba/xai) · [raw index](https://huggingface.co/spaces/lyffseba/xai/raw/main/index.html) (no CDN lag) · [dataset](https://huggingface.co/datasets/lyffseba/xai-studies).

## layout

```
studies/models/<id>/{book,code-study,reference,derived,scripts}
studies/shared/     glossary · comparison
studies/run.py      offline validate (stdlib)
dissertation/       MSc notebook
hf/                 Space + Dataset package
```

- `reference/` — primary sources (Hub, blogs, papers)  
- `derived/` — generated SPECs (do not hand-edit)  
- `book/` / `code-study/` — narrative + walkthrough  

## commands

```
make test                       # offline validate
make check                      # re-derive from local sources
make refresh MODEL=inkling      # online re-fetch
make sync                       # push GitHub + HF
```

## what this is not

Not a training framework, not a weight host, not affiliated with Thinking Machines, Moonshot, or Poolside.  
Secondary blogs are never sole authority for architecture numbers.

## license

Study notes: [Apache-2.0](LICENSE). Upstream snapshots keep original licenses — [NOTICE](NOTICE).

---

last update: 2026-07-23