omm link
설치된 모든 모델의 링크를 설치된 모든 러너에 대해 다시 확인하고 복구합니다 — 또는 omm이 직접 지원하지 않는 앱을 위해 허브 전체를 특정 디렉터리에 링크합니다.
01 / 06
개요
새 러너를 설치한 다음(그 전에 설치된 모델도 새 러너에 연결되도록), 또는 scan이 "설치된 엔진에 아직 링크되지 않음" 힌트를 보여줄 때 쓰는 명령입니다. 디렉터리 없이 실행하면 설치된 모든 모델을 설치된 모든 러너에 항상 다시 링크합니다 — 한 번도 안 걸린 것과 조용히 깨진 것 둘 다 포함하는데, 캐시된 linked 플래그를 절대 그대로 믿지 않기 때문입니다. 디렉터리를 주면, omm이 기본 지원하는 일곱 개가 아닌 앱을 위해 가능하면 복사 대신 중앙 파일을 직접 재사용합니다.
02 / 06
옵션
이 명령이 받는 모든 옵션과, 생략했을 때의 기본값입니다.
[directory]—기본값: none — repairs known app linksomm이 직접 지원하지 않는 앱을 위해, 설치된 모든 모델 파일을 링크할 추가 디렉터리.
--engineNAME기본값: every engine이 엔진 하나의 링크만 다시 확인·복구합니다.
--force—기본값: offomm이 자기 것으로 인식하지 못하는 대상을 충돌로 건너뛰는 대신, 지우고 다시 링크해서 되찾습니다.
03 / 06
예제
기본 검색부터 스크립트에 넣을 만한 형태까지.
설치된 모든 모델의 링크를 설치된 모든 러너에 대해 다시 확인·복구합니다.
$ omm linkOllama 링크만 복구합니다.
$ omm link --engine ollama지원하지 않는 앱을 위해 설치된 모든 모델을 디렉터리에 링크합니다.
$ omm link ~/my-runner/models04 / 06
실제 실행 예시
2026-08-25, 실제로 실행한 omm link입니다: 임시 OMM_HOME 기준으로 작은 모델을 실제 설치하고, link를 실제로 실행해서 실제 Ollama 심볼릭 링크를 다시 썼고(link가 원래 하는 일 그대로), 캡처 직후 바로 제거했습니다 — 실제 ollama list에서도 제거된 걸 확인했습니다. "0 skipped (file missing)"은 실제 정확한 문구입니다 — 이전 버전 페이지가 실행해보지 않고 추측했던 "missing"이 아닙니다.
06 / 06
문제가 생겼다면
아래 메시지는 모두 이 명령이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.
--engine must be one of: anythingllm, jan, koboldcpp, lmstudio, mstystudio, ollama, textgenwebui (got 'bogus').- 원인
- --engine은 실제 존재하는 엔진 키만 받는데, 이번 실행에서는 다른 값을 줬습니다.
- 대처
- 메시지에 나열된 일곱 개 중 하나를 쓰세요.
- 출처
- src/omm/cli.py:909-911
--engine only applies without a directory argument.- 원인
- --engine은 복구할 러너 하나를 좁히는 옵션이고, 디렉터리 인자는 전혀 다른 뜻입니다 — 알려진 일곱 러너가 아닌 위치에 링크하겠다는 것. 둘은 같이 쓸 수 없습니다.
- 대처
- 러너 하나만 복구하려면 --engine만, 커스텀 위치에 링크하려면 디렉터리만 쓰세요.
- 출처
- src/omm/cli.py:6501-6502
그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로를 첨부해 이슈를 등록하세요.
전체 명령어
- omm search큐레이션 카탈로그, HuggingFace, ModelScope에서 모델을 한 번에 찾습니다.
- omm install모델을 허브에 내려받아 설치된 모든 러너에 연결합니다.
- omm run설치한 모델과 대화합니다 — Ollama는 터미널에서, GUI 러너는 앱을 열어서.
- omm recommend이 머신 하드웨어에 맞춰 순위 매긴 모델을 추천하고, 설치까지 제안합니다.
- omm contribute모델을 반복 벤치마크하며 텔레메트리를 업로드해, 이런 하드웨어용 recommend를 개선합니다.
- omm setup하드웨어 스캔과 러너 설치 체크리스트를 언제든 다시 실행합니다.
- omm scan이 머신의 하드웨어·감지된 러너·모델을 보여줍니다 — 옵션 없이 바로.
- omm tune모델에 맞는 컨텍스트 길이·GPU 오프로드·스레드·배치 크기 추천값을 받습니다.
- omm fit설치 여부와 상관없이 지금 이 머신 여유 메모리에 모델이 맞는지 봅니다.
- omm helpomm 자체 명령어 요약, 또는 --all로 전체 레퍼런스를 봅니다.
- omm import다른 앱의 모델 디렉터리에 있는 .gguf 파일을 omm 허브로 편입시킵니다.
- omm uninstall모델을 제거하고 심볼릭 링크·매니페스트를 정리합니다. 별칭: rm.
- omm listomm이 설치한 모든 모델과 각각 어떤 러너에 연결돼 있는지 봅니다. 별칭: ls.
- omm info설치된 모델 하나의 저장소·버전·크기·링크·실행 명령을 자세히 봅니다.
- omm upgrade설치된 모델을 소스 기준으로 새로고침 — 실제로 바뀐 것만 다시 내려받습니다. 별칭: up.
- omm cleanup남은 부분 다운로드와 깨진 러너 심볼릭 링크를 한 번에 정리합니다 — 옵션 없이 바로.
- omm verify설치된 모델이 이 머신에서 실제로 로드되고 텍스트를 생성하는지 증명합니다.
- omm benchmark설치된 모델 하나 이상의 로컬 품질·속도 증거를 남깁니다.
- omm update최신 소스로 omm을 재설치하고 추천 데이터를 새로고침합니다.
- omm settingomm 설정을 보거나 바꿉니다 — 텔레메트리·외부 전송 데이터·테마·업데이트 채널 등.
- omm doctoromm 설치와 Ollama 링크를 읽기 전용으로 진단합니다 — 옵션 없이 바로.
- omm engine install설정 체크리스트를 건너뛰고 로컬 AI 러너 하나를 바로 설치합니다.
- omm log로컬 실행 로그를 읽습니다 — omm이 뭘 실행했고 잘 됐는지.
- README — UsageEvery omm command, one line each.