omm

omm uninstall

Remove a model and clean up every symlink and manifest entry it left behind — or preview exactly that with --dry-run first.

01 / 06

Overview

Reach for uninstall once you're done with a model. Pass all to remove every model omm has installed in one pass. --dry-run answers "what would this actually do" without deleting anything — worth reaching for first if you're not sure exactly what all currently covers.

02 / 06

Options

Every flag this command accepts, and what it defaults to when you leave it out.

  • <name> | all—Default: required

    An installed model's filename, a numeric index from the last search or list run, or the literal word all.

  • --dry-run—Default: off

    Show what would be uninstalled without removing anything.

03 / 06

Examples

From a plain search to something you'd put in a script.

Uninstall one model.

$ omm uninstall qwen2.5-0.5b-instruct-q4_k_m.gguf

Preview it first — nothing is removed.

$ omm uninstall qwen2.5-0.5b-instruct-q4_k_m.gguf --dry-run

Preview uninstalling everything omm has installed.

$ omm uninstall all --dry-run

Uninstall by the number the last search or list run printed.

$ omm uninstall 1

04 / 06

A real run

Real omm uninstall qwen2.5-0.5b-instruct-q4_k_m.gguf --dry-run capture, 2026-08-24, this dev machine.

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.

  1. zzzz-fake-model-xyz is not installed via omm. See `omm list`.
    why
    This name doesn't match anything omm has installed — misspelled, or never installed through omm in the first place.
    what to do
    Run omm list to see the exact filename omm knows about.
    source
    src/omm/cli.py:5008-5013
  2. Run `omm search` or `omm list` first to install/uninstall by number.
    why
    A numeric index only means something after a search or list run in the same terminal printed one — there's nothing to resolve it against yet.
    what to do
    Run omm search or omm list first, then use the number it printed.
    source
    src/omm/cli.py:3057-3059

Still stuck? Open an issue with the exact message you saw.

All commands