omm

omm import

Scan every supported local AI app for .gguf files omm doesn't manage yet, and offer to adopt each one into the hub.

01 / 06

Overview

Reach for import when omm scan's "Found model file(s) outside the omm hub" note shows up, or any time you know a runner has models you downloaded outside of omm. It scans every supported app's model directory (and an optional extra path you pass) for files not yet registered, then offers to adopt each one — moving it into the central hub and linking it back in, so a byte-identical copy stops sitting in two places.

02 / 06

Options

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

  • [path]—Default: none — scans the usual app directories

    An extra directory to also scan, beyond the usual app directories.

03 / 06

Examples

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

Scan the usual app directories.

$ omm import

Also scan an extra directory.

$ omm import ~/Downloads

Adopt everything found without asking about each one.

$ omm import --yes

04 / 06

A real run

Real omm import run, 2026-08-25, driven end to end through a real terminal: two copies of the same real GGUF (one already installed on this dev machine) were planted under a throwaway extra directory so import would find a genuine duplicate to adopt, instead of a real ~/Downloads that happened to have nothing stray in it. import found both real copies, asked to confirm, showed the real pre-checked picker, and actually moved the file into a throwaway hub — the 0.5 GB saved is real disk space reclaimed by deduplication, the whole reason this command exists.

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. No externally-managed .gguf files found.
    why
    Every supported app directory (and any extra path passed) came back with nothing import doesn't already manage.
    what to do
    Nothing to do — there's nothing stray to adopt right now.
    source
    src/omm/cli.py:1421
  2. Not a directory: /definitely/not/a/real/directory
    why
    The extra path passed doesn't exist or isn't a directory.
    what to do
    Double check the path, or omit it to just scan the usual app directories.
    source
    src/omm/cli.py:1490

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

All commands