omm

omm import

지원하는 모든 로컬 AI 앱을 뒤져서 omm이 아직 관리하지 않는 .gguf 파일을 찾고, 발견하는 대로 허브 편입을 제안합니다.

01 / 06

개요

omm scan이 "omm 허브 밖에서 모델 파일을 발견했습니다"라고 알려줄 때, 또는 omm을 거치지 않고 내려받은 모델이 러너에 있다는 걸 알 때 쓰는 명령입니다. 지원하는 모든 앱의 모델 디렉터리(그리고 추가로 넘긴 경로)를 뒤져서 아직 등록 안 된 파일을 찾은 다음, 발견한 각각을 편입시킬지 제안합니다 — 중앙 허브로 옮기고 다시 연결해서, 바이트가 똑같은 사본이 두 곳에 있는 상태를 없앱니다.

02 / 06

옵션

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

  • [path]—기본값: none — scans the usual app directories

    평소 앱 디렉터리 외에 추가로 스캔할 디렉터리.

03 / 06

예제

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

평소 앱 디렉터리를 스캔합니다.

$ omm import

추가 디렉터리도 함께 스캔합니다.

$ omm import ~/Downloads

발견한 것을 하나씩 묻지 않고 전부 편입시킵니다.

$ omm import --yes

04 / 06

실제 실행 예시

2026-08-25, 실제 터미널로 처음부터 끝까지 직접 진행한 omm import 실행입니다: 실제 있을 법한 ~/Downloads가 우연히 비어 있는 대신, 이 개발 머신에 이미 설치된 실제 GGUF 파일 사본 2개를 임시 추가 디렉터리에 일부러 넣어서 import가 진짜 중복 파일을 찾도록 했습니다. import는 실제 사본 2개를 찾았고, 확인을 물었고, 실제 체크박스 화면(미리 선택됨)을 보여준 다음, 실제로 파일을 임시 허브로 옮겼습니다 — 0.5GB 절약은 중복 제거로 실제 회수된 디스크 공간이고, 이게 이 명령이 존재하는 이유 그 자체입니다.

06 / 06

문제가 생겼다면

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

  1. No externally-managed .gguf files found.
    원인
    지원하는 모든 앱 디렉터리(그리고 넘긴 추가 경로)를 다 뒤졌는데 import가 아직 관리하지 않는 게 하나도 없었습니다.
    대처
    별도 조치 필요 없습니다 — 지금은 편입시킬 게 없습니다.
    출처
    src/omm/cli.py:1421
  2. Not a directory: /definitely/not/a/real/directory
    원인
    추가로 넘긴 경로가 존재하지 않거나 디렉터리가 아닙니다.
    대처
    경로를 다시 확인하거나, 생략하고 평소 앱 디렉터리만 스캔하세요.
    출처
    src/omm/cli.py:1490

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

전체 명령어