ommv0.2.148

omm search

omm의 큐레이션 카탈로그, 캐시된 후보, HuggingFace, ModelScope를 한 번의 검색으로 조회합니다.

01 / 06

개요

install 전에 먼저 쓰는 명령입니다. install이 받는 정확한 저장소 참조나 번호를 여기서 찾습니다. 결과는 모델 계열별로 묶여 터미널에 번호가 매겨지고, 이 하드웨어에서 못 돌아갈 걸로 예측되는 모델은 감춰지는 대신 빨간색으로 표시됩니다 — --skip-unfit을 주면 그때는 아예 제외됩니다. search가 매긴 번호는 그 명령을 실행한 터미널 안에서만 유효합니다: 다음 search나 list를 실행하면 번호가 다시 매겨집니다.

02 / 06

옵션

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

  • <query>—기본값: required

    검색할 텍스트. 큐레이션/캐시 카탈로그를 먼저 매칭한 다음 HuggingFace, ModelScope 순으로 찾습니다.

  • --skip-unfit—기본값: off

    이 하드웨어에서 못 돌아갈 걸로 예측되는 모델을 빨간색으로 보여주는 대신 결과에서 아예 뺍니다.

  • --limitN기본값: no limit

    결과를 이 개수까지만 보여줍니다.

  • --providercurated | huggingface | modelscope기본값: all three

    이 출처의 결과만 보여줍니다: curated(실제 호스트가 아닌 omm 내장/캐시 카탈로그), huggingface, modelscope 중 하나.

  • --skip-ms—기본값: off

    ModelScope는 조회하지 않습니다. ModelScope 결과는 후보 저장소마다 네트워크 요청이 하나씩 더 필요해서 검색이 눈에 띄게 느려질 수 있습니다.

  • --json—기본값: off

    정돈된 목록 대신 구조화된 JSON을 표준출력으로 찍습니다 — search가 표준출력에 쓰는 유일한 것이라 파이프로 안전하게 연결할 수 있습니다.

  • --yes, -y—기본값: off

    전역 옵션으로는 받지만 search에는 건너뛸 확인 프롬프트가 없습니다. omm이 경고를 출력하고 무시합니다.

  • --quiet, -q—기본값: off

    진행 표시줄과 백그라운드 상태·힌트 줄을 숨깁니다. 에러와 검색 결과는 그대로 출력됩니다.

  • --no-color—기본값: off

    터미널 색상 출력을 끕니다.

  • --help—기본값: off

    search의 사용법·인자·옵션을 출력하고 종료합니다.

03 / 06

예제

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

기본 검색 — 계열별로 묶여 번호가 매겨집니다. 이 번호를 install에 그대로 넘길 수 있습니다.

$ omm search qwen

결과 개수를 제한합니다.

$ omm search qwen --limit 3

이 머신에서 못 돌아갈 걸로 예측되는 모델은 빨간색 표시 대신 아예 뺍니다.

$ omm search qwen --skip-unfit

큐레이션 카탈로그와 ModelScope는 건너뛰고 HuggingFace 결과만 봅니다.

$ omm search qwen --provider huggingface

JSON 출력을 jq로 연결합니다 — search가 표준출력에 쓰는 게 --json뿐이라 안전합니다.

$ omm search qwen --json | jq '.[0]'

04 / 06

실제 CLI 실행 녹화

이 영상에서 실제로 실행한 명령

omm search llama --skip-ms --limit 4 --no-color

종료 코드: 0 · 결과: 완료

외부 네트워크를 차단한 격리 환경에서 읽기 전용으로 캡처했습니다.

실제 프로세스 원문 transcript 열기(.txt)

확장 문서 터미널 예시

2026-08-24, 이 개발 머신에서 실제로 실행한 omm search qwen 캡처입니다. 전체 60개 결과 중 앞 6개만 남겼습니다. HuggingFace·ModelScope 순위는 계속 바뀌므로 다시 실행하면 다른 저장소가 나옵니다.

06 / 06

문제가 생겼다면

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

  1. --provider must be one of: curated, huggingface, modelscope (got 'bogus').
    원인
    --provider는 세 값 중 하나만 받는데, 이번 실행에서는 다른 값을 줬습니다.
    대처
    curated, huggingface, modelscope 중 하나를 쓰세요.
    출처
    src/omm/cli.py:6318-6320
  2. --skip-ms conflicts with --provider modelscope.
    원인
    --skip-ms는 ModelScope를 조회하지 말라는 뜻이고, --provider modelscope는 ModelScope 결과만 보여달라는 뜻입니다. 서로 상쇄됩니다.
    대처
    --skip-ms를 빼거나, --provider를 curated나 huggingface로 바꾸세요.
    출처
    src/omm/cli.py:6323
  3. No models found matching 'zzzznonexistentmodelxyz'.
    원인
    큐레이션 카탈로그, 캐시된 후보, HuggingFace, ModelScope 어디에도 이 검색어와 일치하는 게 없었습니다.
    대처
    더 짧거나 다르게 쓴 검색어를 시도하세요 — search는 정확한 저장소 ID가 아니라 이름으로 매칭합니다.
    출처
    src/omm/cli.py:6359

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