omm

omm scan

이 머신의 하드웨어, 감지된 로컬 AI 러너, omm이 알고 있는 모든 모델을 요약해 보여줍니다.

01 / 06

개요

이 머신이 뭘 돌릴 수 있고 이미 뭐가 있는지 스냅샷이 필요할 때 쓰는 명령입니다. 보고서 자체는 관찰용이지만, 제거된 러너가 있으면 scan이 오래된 링크 레코드를 바로잡을 수 있습니다. omm link나 omm import가 필요해 보이면 힌트도 붙여줍니다.

02 / 06

옵션

이 명령이 받는 모든 옵션과, 생략했을 때의 기본값입니다.

  • --json—기본값: off

    같은 리포트를 표 대신 구조화된 JSON으로 출력합니다.

03 / 06

예제

기본 검색부터 스크립트에 넣을 만한 형태까지.

하드웨어·러너·모델 전체 리포트.

$ omm scan

기계가 읽을 수 있는 형태 — 같은 필드를 JSON으로.

$ omm scan --json

출력될 수 있는 두 힌트 줄을 생략합니다.

$ omm scan --quiet

04 / 06

실제 실행 예시

2026-08-24, 이 개발 머신에서 실제로 실행한 omm scan 캡처입니다.

06 / 06

문제가 생겼다면

아래 메시지는 모두 이 명령이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.

  1. Some omm-hub models aren't linked into an installed engine yet. Run: omm link
    원인
    omm 허브에 있는 모델인데 지금 설치된 러너에는 심볼릭 링크가 안 돼 있는 경우입니다 — 보통 모델을 설치한 뒤에 러너를 설치했을 때 생깁니다.
    대처
    omm link를 실행하면 모든 모델의 링크를 한 번에 복구합니다.
    출처
    src/omm/cli.py:1059-1064
  2. Found model file(s) outside the omm hub. Run: omm import
    원인
    scan이 러너 자체의 모델 디렉터리에서 omm을 거치지 않고 들어온 .gguf 파일을 발견했다는 뜻입니다 — 아직 omm이 관리하거나 중복 제거하지 않은 상태입니다.
    대처
    omm import로 허브에 편입시키거나, 직접 관리하고 싶다면 무시해도 됩니다.
    출처
    src/omm/cli.py:1065-1069

그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로를 첨부해 이슈를 등록하세요.

전체 명령어