Checkpoints and LoRAs

The ComfyUI models/ tree (checkpoints/, loras/, …), mounted read-only into the services that list or pin models. Each model's licence comes from its own model card.

Used by

Package	What for	Reads
argus-darkroom (opens in new tab)	Lists the checkpoints a request can name. Mount the folder ComfyUI actually lists, including any from `extra_model_paths`.	`ARGUS_DARKROOM_MODELS_ROOT`, `MODELS_ROOT`, `ARGUS_DARKROOM_DEFAULT_CHECKPOINT`
argus-atlas (opens in new tab)	`bake --checkpoint` (required, named as ComfyUI loads it) and `--lora` for the cartography LoRA. The models dir is used only for SHA256 pinning.	`--checkpoint`, `--lora`, `ATLAS_MODELS_DIR`, `--models-dir`
argus-proof (opens in new tab)	Lists `<dir>/checkpoints` and `<dir>/loras`. Several roots can be joined with `:`.	`PROOF_MODELS_DIR`

Official guides

ComfyUI manual install (opens in new tab): the model folder layout

Minimal setup

Keep checkpoints and LoRAs in ComfyUI's layout: models/checkpoints/, models/loras/ and so on. If ComfyUI also reads folders listed in extra_model_paths.yaml, mount the folder it actually lists.
Mount the tree read-only into each service, at the container path it expects:
- darkroom: host path in MODELS_ROOT, at /models;
- proof: PROOF_MODELS_DIR, for example /data/models:/data/models-extra;
- atlas: ATLAS_MODELS_DIR (default /data/models), used only to pin SHA256s.
Name a model the way ComfyUI loads it, as a path relative to its folder.

To make trained LoRAs show up, point forge's output at the same loras/ folder (see ComfyUI). Atlas's scripts/fetch_civitai_lora.py reads CIVITAI_TOKEN to download the cartography LoRA.