omm

omm cleanup

Remove orphaned partial downloads left by an interrupted install, plus symlinks in runner model directories whose source .gguf was deleted outside of omm uninstall.

01 / 06

Overview

Reach for cleanup after an install was interrupted (network drop, Ctrl+C, a crash) and you want the partial download's disk space back without hunting for the file yourself, or when a runner's own model list shows an entry that no longer loads because the underlying .gguf was deleted by hand. It only ever touches incomplete, unregistered files and links that are already broken — never a finished, installed model still on disk. This is the same sweep omm contribute runs when it finishes.

02 / 06

Options

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

    03 / 06

    Examples

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

    Clean up every leftover install file and broken runner symlink.

    $ omm cleanup

    Same cleanup, without the progress output.

    $ omm cleanup --quiet

    04 / 06

    A real run

    The partial-download half is a real omm cleanup run, 2026-08-25, against a throwaway OMM_HOME seeded with two genuine leftover .gguf.part files (the exact pattern _cleanup_incomplete_installs looks for) — cleanup found and deleted both. The broken-link count is a format-accurate reconstruction: reproducing it for real means corrupting this dev machine's real runner symlinks, which this page won't do. The counts are representative.

    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. Nothing to clean up.
      why
      This is what cleanup prints on a healthy system with nothing to reclaim, which is most runs.
      what to do
      Nothing to do.
      source
      src/omm/cli.py

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

    All commands