# sm121/recipes — recipe repo (public data repo)

The git recipe repo for the [sm121 launcher](https://git.kilork.org/sm121/launcher)
DGX Spark / GB10 cluster toolkit. The launcher (and the Home Assistant
add-on) clone/pull this repo and serve from it:

- **`recipes/<name>/recipe.toml`** — the recipes (source layout, exactly as
  in the launcher repo)
- **`docker-images/<dir>/`** — the image build contexts (source of truth;
  optional when the image is prebuilt in the registry)

Design: [`specs/tech-architecture/ha-addon-recipe-repos.md`](https://git.kilork.org/sm121/launcher/blob/main/specs/tech-architecture/ha-addon-recipe-repos.md)
in the launcher repo.

## No cluster config here (on purpose)

This repo is **public** — and the cluster config (`[[clusters]]` with
private node IPs, host keys, HA entity names) is not shareable. It lives
in the **private** `sm121/cluster-config` repo, which the HA add-on
fetches at boot (`sm121_base_config` option) and uses as its base config.
The Mac launcher reads its own local config.

## Supersedes the old publish-bundle registry

This repo previously stored `sm121 publish` output (flat self-contained
bundles at the repo root) as the storage of the public recipe registry
(`sm121recipes.onlinedb.org`). **That registry is retired** (the
add-on recipe-repo flow supersedes it); the bundles were removed on the
restructure. `sm121 publish` (bundles) and `sm121 registry` (browse/
install) still exist in the launcher but no longer commit to this repo.

## Maintenance

Recipes + build contexts move together (the served image must match the
recipe revision): update this repo from the launcher repo's tracked state
(`scripts/seed-recipe-repos.sh` in the launcher repo shows the layout).