ommv0.2.148

omm setup

처음 실행 시 자동으로 도는 설정 마법사 — 하드웨어 스캔에 이어 설치할 로컬 AI 러너 체크리스트 — 를 언제든 다시 실행합니다.

01 / 06

개요

setup은 omm을 처음 쓸 때 자동으로 도는 것이자, 나중에도 다시 찾게 되는 명령입니다: 건너뛴 러너를 마저 설치하거나 하드웨어 요약을 다시 확인할 때 씁니다. 인자를 전혀 받지 않습니다 — 주된 단계는 하드웨어 요약과 러너 체크리스트(이미 설치된 건 보이지만 선택은 안 됨)입니다. 실제 터미널이 필요합니다 — TTY가 연결돼 있지 않으면 멈추는 대신 바로 실패합니다.

02 / 06

옵션

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

  • --json—기본값: off

    전역 옵션으로는 받지만 setup에는 JSON 출력 모드가 없습니다. omm이 경고를 출력하고 무시합니다.

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

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

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

    마법사가 고른 러너를 설치하는 동안의 진행 줄만 숨깁니다. 프롬프트·경고·마지막 요약은 그대로 출력됩니다.

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

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

  • --help—기본값: off

    setup의 사용법과 옵션을 출력하고 종료합니다.

03 / 06

예제

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

전체 마법사: 하드웨어 요약에 이어 러너 체크리스트까지.

$ omm setup

같은 마법사, 러너 설치 중 줄 단위 진행 출력만 없앤 버전.

$ omm setup --quiet

터미널 색상을 뺀 일반 텍스트 출력 — 제한된 터미널이나 로그에 유용합니다.

$ omm setup --no-color

04 / 06

실제 CLI 실행 녹화

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

omm setup --no-color

종료 코드: 1 · 결과: 사용자 취소

기록된 키보드 입력으로 설치·모델 실행·벤치마크·업로드가 시작되기 전에 취소했습니다.

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

확장 문서 터미널 예시

2026-08-24, 이 개발 머신에서 실제로 실행한 omm setup 캡처입니다 — 배너와 하드웨어 표는 console.print로 출력되는 부분이라 그대로 캡처했습니다. 뒤이어 나오는 러너 체크리스트는 questionary가 터미널에 직접 그리는 부분이라(recommend의 선택 목록이 일반 캡처에 안 찍히는 것과 같은 이유) 여기 옮기지 않았습니다.

06 / 06

문제가 생겼다면

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

  1. Engine selection requires an interactive terminal. Re-run this command from a real terminal.
    원인
    러너 체크리스트는 대화형 프롬프트인데, 이번 실행의 표준입력이 실제 터미널이 아니었습니다(파이프로 연결됐거나 스크립트에서 실행된 경우 등).
    대처
    실제 터미널에서 omm setup을 실행하세요.
    출처
    src/omm/onboarding.py:220-225
  2. AnythingLLM isn't auto-installable yet. Install it yourself, then re-run `omm setup` or `omm link`. See https://github.com/omm-hippo/omm/wiki/Compatible-Programs
    원인
    일부 러너는 아직 모든 플랫폼에 자동 설치 방법이 없습니다 — 이 시스템에서는 직접 설치해야 합니다.
    대처
    호환 프로그램 목록을 보고 직접 설치한 다음, omm setup이나 omm link를 다시 실행해 omm이 인식하게 하세요.
    출처
    src/omm/onboarding.py:257-262
  3. Only 3.2 GB is free on the drive holding omm's home. Models and runners install there - set OMM_HOME to a roomier drive (e.g. `OMM_HOME=D:\omm`, see README) before installing anything.
    원인
    OMM_HOME이 있는 드라이브의 여유 공간이 10 GB보다 적어, 일반적인 모델 파일과 러너를 안전하게 설치하기 빠듯합니다.
    대처
    그 드라이브의 공간을 확보하거나, 설치 전에 OMM_HOME을 더 여유 있는 드라이브로 지정하세요.
    출처
    src/omm/onboarding.py:86-91

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