omm upgrade
Refresh an installed model against its source, re-downloading only if it's actually changed since install.
01 / 06
Overview
Reach for upgrade to check whether an installed model has been updated upstream since you installed it. With no argument (or all) it checks everything omm has installed; a single name checks just that one. It never re-downloads a model whose source hash hasn't changed, so running it against everything is cheap when nothing's actually different — --dry-run shows exactly what it would check without even that.
02 / 06
Options
Every flag this command accepts, and what it defaults to when you leave it out.
[name] | all—Default: all installed modelsAn installed model's filename, or all (also the default with no argument).
--dry-run—Default: offShow what would be checked for updates without downloading anything.
03 / 06
Examples
From a plain search to something you'd put in a script.
Check every installed model for updates.
$ omm upgradePreview checking one model — nothing downloads.
$ omm upgrade qwen2.5-0.5b-instruct-q4_k_m.gguf --dry-runPreview checking everything — nothing downloads.
$ omm upgrade --dry-run04 / 06
A real run
Real omm upgrade --dry-run capture, 2026-08-24, this dev machine — both installed models listed.
06 / 06
If something goes wrong
Every message below is one this command actually prints. Find yours, read why it happened, then do the last line.
zzzz-fake-model-xyz is not installed via omm. See `omm list`.- why
- This name doesn't match anything omm has installed.
- what to do
- Run omm list to see the exact filename omm knows about.
- source
- src/omm/cli.py:5676
Still stuck? Open an issue with the exact message you saw.
All commands
- omm searchFind a model across the curated catalog, HuggingFace and ModelScope.
- omm installDownload a model into the hub and link it into every installed runner.
- omm runChat with an installed model — in the terminal for Ollama, or by opening the app for GUI runners.
- omm recommendGet a model suggestion ranked for this machine's hardware, with an offer to install it.
- omm contributeBenchmark models in a loop, uploading telemetry to improve recommend for hardware like yours.
- omm setupRe-run the hardware scan and runner-install checklist, any time.
- omm scanPrint this machine's hardware, detected runners, and models — no flags needed.
- omm tuneGet recommended context length, GPU offload, threads, and batch size for a model.
- omm fitSee whether a model fits this machine's free memory right now, installed or not.
- omm helpShow omm's own command summary, or the full reference with --all.
- omm importAdopt .gguf files sitting in other apps' model directories into the omm hub.
- omm uninstallRemove a model and clean up its symlinks and manifests. Alias: rm.
- omm listShow every model omm has installed and which runners each is linked into. Alias: ls.
- omm infoShow full detail — repo, version, size, links, run commands — for one installed model.
- omm linkRe-verify and repair every installed model's runner links, or link into a custom directory.
- omm cleanupClean up leftover partial downloads and broken runner symlinks in one pass — no flags needed.
- omm verifyProve that an installed model actually loads and generates text on this machine.
- omm benchmarkLocal quality and speed smoke evidence for one or more installed models.
- omm updateReinstall omm from the latest source and refresh its recommendation data.
- omm settingView or change omm's settings — telemetry, outbound data, theme, update channel, and more.
- omm doctorDiagnose the omm install and Ollama links, read-only — no flags needed.
- omm engine installInstall one local AI runner program directly, skipping the setup checklist.
- omm logRead the local run log: what omm ran, when, and whether it worked.
- README — UsageEvery omm command, one line each.