omm

omm setup

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

01 / 06

개요

setup은 omm을 처음 쓸 때 자동으로 도는 것이자, 나중에도 다시 찾게 되는 명령입니다: 건너뛴 러너를 마저 설치하거나, 하드웨어 요약을 다시 확인하거나, 셸 자동 완성을 켤 때. 인자를 전혀 받지 않습니다 — 하는 일은 전부 대화형 단계입니다: 하드웨어 요약, 러너 체크리스트(이미 설치된 건 보이지만 선택은 안 됨), 데이터 공유 여부를 한 번 묻는 단계, 셸 자동 완성 활성화 제안. 데이터 공유 단계는 익명 일일 배치 하나에 정확히 뭐가 담기는지 그대로 보여주고 기본값은 아니요입니다. 예라고 답하면 크래시 리포트도 같이 켜지며, 어느 쪽이든 나중에 omm setting upload로 바꿀 수 있습니다. 실제 터미널이 필요합니다 — TTY가 연결돼 있지 않으면 멈추는 대신 바로 실패하고, 비대화형 실행에서는 사용 통계와 크래시 리포트가 꺼진 채로 남습니다.

02 / 06

옵션

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

  • --quiet—기본값: off

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

03 / 06

예제

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

전체 마법사: 하드웨어 요약, 러너 체크리스트, 자동 완성 제안까지.

$ omm setup

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

$ omm setup --quiet

04 / 06

실제 실행 예시

실제 터미널로 직접 진행한 두 번의 실행을 합친 캡처이고, 두 번 다 임시 OMM_HOME을 써서 이 머신의 진짜 설정은 전혀 손대지 않았습니다. 배너·테마 선택·하드웨어 요약·러너 체크리스트는 2026-08-25 실행분으로, 이 세션의 노트북 대신 recommend 페이지와 같은 중급 사양 PC(Intel Core Ultra 7 155H, RAM 15.5GB, Intel Arc, Ollama·LM Studio·Jan 이미 설치됨) 기준입니다. 데이터 공유 패널과 거절 응답, 마지막 마무리 줄은 데이터 공유 단계가 들어온 뒤인 2026-09-01에 이 세션의 노트북에서 다시 캡처했고, 패널 테두리까지 그대로입니다. 테마 선택·러너 체크리스트·동의 프롬프트는 questionary가 터미널에 직접 그리는 화면이라 일반 표준출력이 아니라 터미널 에뮬레이터로 캡처했습니다.

06 / 06

문제가 생겼다면

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

  1. Engine selection requires an interactive terminal. Re-run this command from a real terminal.
    원인
    러너 체크리스트는 대화형 프롬프트인데, 이번 실행의 표준입력이 실제 터미널이 아니었습니다(파이프로 연결됐거나 스크립트에서 실행된 경우 등).
    대처
    실제 터미널에서 omm setup을 실행하세요.
    출처
    src/omm/onboarding.py:232-233
  2. AnythingLLM isn't auto-installable yet. Install it yourself, then re-run `omm setup` or `omm link`. See https://omm.run/#runners
    원인
    일부 러너는 아직 모든 플랫폼에 자동 설치 방법이 없습니다 — 이 시스템에서는 직접 설치해야 합니다.
    대처
    호환 프로그램 목록을 보고 직접 설치한 다음, omm setup이나 omm link를 다시 실행해 omm이 인식하게 하세요.
    출처
    src/omm/onboarding.py:276-278
  3. Couldn't enable tab-completion automatically. Run `omm --install-completion` to set it up manually.
    원인
    자동 완성을 켜려면 셸 설정 파일에 써야 하는데, 그 셸이나 설정 파일 권한 특유의 이유로 실패할 수 있습니다.
    대처
    omm --install-completion을 직접 실행해 실제 에러를 확인하거나, 수동으로 설정하세요.
    출처
    src/omm/onboarding.py:396-397

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

전체 명령어