Model storage

warning

Model storage

Default locations (Windows)

Content	Path
Models	`%USERPROFILE%\botconnector\models`
Runtimes	`%USERPROFILE%\botconnector\runtimes`
Model metadata snapshots	`%USERPROFILE%\botconnector\models\.meta`
Logs	`%USERPROFILE%\botconnector\logs`

Structure

Each model directory contains the GGUF file(s) plus its metadata snapshot:

text

%USERPROFILE%\botconnector\models\
  publisher--model\
    model-Q4_K_M.gguf
    meta.json

Sharded models are stored as their parts (-00001-of-00003.gguf, …) and reassembled logically at load time.

Changing the location

Point the model store at another drive (useful for large libraries):

powershell

botconnector config set models.dir "D:\botconnector-models"
botconnector doctor

Existing files can be moved; run doctor afterwards to confirm the store is found.

Disk space

GGUF libraries grow quickly. botconnector ls shows per-model sizes; delete unused models to reclaim space — see Installed models. Runtime packages are separate and typically 200–500 MB each; unused backends can be removed too.

Backup

Copy the model store directory to back it up. Metadata snapshots travel with the files, so a restored copy is immediately listable offline. See Offline usage.

Troubleshooting

Full disk during download, files in unexpected locations: Download problems.