omm contribute
하드웨어에 맞는 모델을 반복해서 설치·벤치마크·텔레메트리 업로드한 다음 지우는 과정을 반복해, omm recommend의 학습 데이터를 키웁니다.
01 / 06
개요
contribute는 omm 명령 중 유일하게 한동안 방치해도 되도록 만들어진 명령입니다: 후보를 내려받아 벤치마크하고, 현재 업로드 정책에 따라 결과를 올리고, 디스크 사용량을 억제하기 위해 모델을 지운 다음, Esc를 누르거나 이 하드웨어가 아직 안 다룬 후보가 바닥날 때까지 반복합니다. 모든 모델 볼륨에 실제 여유 공간이 있어야 시작하고, 뭐든 내려받기 전에 아래의 동의 안내문을 정확히 출력합니다.
02 / 06
옵션
이 명령이 받는 모든 옵션과, 생략했을 때의 기본값입니다.
--report-errors—기본값: off이번 실행에서만 정리된 에러 리포트를 보냅니다. 저장된 정책은 바꾸지 않고, 에러 리포트가 명시적으로 꺼져 있으면 무시됩니다.
--json—기본값: off전역 옵션으로는 받지만 contribute에는 JSON 출력 모드가 없습니다. omm이 경고를 출력하고 무시합니다.
--yes, -y—기본값: off'Start contributing compute now?' 확인과 모델별 프롬프트를 모두 건너뜁니다 — 방치 실행에 필요합니다.
--quiet, -q—기본값: off진행 표시줄과 백그라운드 상태·힌트 줄을 숨깁니다. 에러와 벤치마크 결과는 그대로 출력됩니다.
--no-color—기본값: off터미널 색상 출력을 끕니다.
--help—기본값: offcontribute의 사용법과 옵션을 출력하고 종료합니다.
03 / 06
예제
기본 검색부터 스크립트에 넣을 만한 형태까지.
대화형 — 동의 안내문을 출력한 다음 시작하기 전에 물어봅니다.
$ omm contribute방치 실행 — 확인 없이, Esc를 누르거나 후보가 바닥날 때까지 돕니다.
$ omm contribute --yes이번 실행의 에러 리포트도 함께 보냅니다.
$ omm contribute --report-errors기본 ~/.omm 대신 여유 있는 볼륨에 모델을 저장합니다 — README에서 그대로 가져온 예제입니다.
$ OMM_HOME=/mnt/data/omm omm contribute --yes04 / 06
실제 CLI 실행 녹화
이 영상에서 실제로 실행한 명령
omm contribute --no-color종료 코드: 0 · 결과: 사용자 취소
기록된 키보드 입력으로 설치·모델 실행·벤치마크·업로드가 시작되기 전에 취소했습니다.
확장 문서 터미널 예시
omm contribute가 뭐든 내려받기 전에 실제로 출력하는 동의 안내문을 그대로 옮긴 것입니다(src/omm/cli.py:8512-8540), Ollama 엔진 기준이고 업로드 정책은 기본값인 'ask'로 표시됩니다 — 실제 실행 전체를 캡처한 건 아닙니다. 실제 실행은 실제 모델을 반복해서 내려받고 벤치마크하고 업로드하고 지우는데, 이 페이지는 그걸 실행하지 않습니다.
06 / 06
문제가 생겼다면
아래 메시지는 모두 이 명령이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.
omm contribute requires benchmark uploads to be enabled. Run `omm setting upload --enable` or `--ask` first.- 원인
- contribute는 항상 벤치마크 결과를 업로드합니다 — 그게 이 명령의 존재 이유라, 업로드가 아예 꺼져 있으면 시작을 거부합니다.
- 대처
- omm setting upload --enable이나 --ask를 실행한 다음 다시 시도하세요.
- 출처
- src/omm/cli.py:8425-8429
Neither Ollama nor LM Studio is installed or available. Install one of them, start it once, then retry `omm contribute`.- 원인
- 벤치마크하려면 모델을 로드할 실행 중인 엔진이 필요한데, contribute는 Ollama나 LM Studio만 구동할 줄 압니다.
- 대처
- Ollama나 LM Studio 중 하나를 설치하고 한 번 실행한 다음 다시 시도하세요.
- 출처
- src/omm/cli.py:8447-8453
omm contribute will not start with low disk space. Keep at least 10 GiB free on every model volume before an unattended run. /Users/you/.omm/models: 3.2 GiB free.- 원인
- 후보마다 중앙 다운로드에 더해 최악의 경우 엔진 사본까지 들어갈 여유가 필요합니다 — contribute는 방치 실행을 시작하기 전에 이걸 확인하지, 도중에 확인하지 않습니다.
- 대처
- 메시지에 나온 볼륨(정확한 필요량이 메시지에 있습니다)의 공간을 확보하거나, OMM_HOME을 여유 있는 드라이브로 지정하세요.
- 출처
- src/omm/cli.py:7864-7871
그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로를 첨부해 이슈를 등록하세요.
전체 명령어
- omm search큐레이션 카탈로그, HuggingFace, ModelScope에서 모델을 한 번에 찾습니다.
- omm install모델을 허브에 내려받아 설치된 모든 러너에 연결합니다.
- omm run설치한 모델과 대화합니다 — Ollama는 터미널에서, GUI 러너는 앱을 열어서.
- omm recommend이 머신 하드웨어에 맞춰 순위 매긴 모델을 추천하고, 설치까지 제안합니다.
- omm setup하드웨어 스캔과 러너 설치 체크리스트를 언제든 다시 실행합니다.
- README — UsageEvery omm command, one line each.