omm cleanup
설치 중단으로 남은 부분 다운로드와, 원본 .gguf가 omm uninstall을 거치지 않고 지워진 뒤 러너 모델 디렉터리에 남은 심볼릭 링크를 함께 제거합니다.
01 / 06
개요
설치가 중단됐을 때(네트워크 끊김, Ctrl+C, 크래시) 파일을 직접 찾지 않고 부분 다운로드가 쓴 디스크 공간을 되찾고 싶을 때, 또는 밑에 깔린 .gguf가 손으로 지워져 러너 자체 모델 목록에 더 이상 로드되지 않는 항목이 보일 때 쓰는 명령입니다. 완료되지 않은 등록 안 된 파일과 이미 깨진 링크만 건드립니다 — 디스크에 아직 있는, 완료돼 설치된 모델은 절대 건드리지 않습니다. omm contribute가 끝날 때 돌리는 것과 같은 정리입니다.
02 / 06
옵션
이 명령이 받는 모든 옵션과, 생략했을 때의 기본값입니다.
03 / 06
예제
기본 검색부터 스크립트에 넣을 만한 형태까지.
남은 설치 파일과 깨진 러너 심볼릭 링크를 전부 정리합니다.
$ omm cleanup같은 정리를, 진행 출력 없이.
$ omm cleanup --quiet04 / 06
실제 실행 예시
부분 다운로드 쪽은 2026-08-25, 임시 OMM_HOME에 실제 남은 .gguf.part 파일 2개를 일부러 만들어 두고(_cleanup_incomplete_installs가 찾는 바로 그 패턴) 실제로 실행한 omm cleanup입니다 — cleanup이 둘 다 찾아서 지웠습니다. 깨진 링크 개수는 재구성한 값입니다: 실제로 재현하려면 이 개발 머신의 진짜 러너 심볼릭 링크를 망가뜨려야 하는데, 이 페이지는 그렇게 하지 않습니다. 개수는 대표값입니다.
06 / 06
문제가 생겼다면
아래 메시지는 모두 이 명령이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.
Nothing to clean up.- 원인
- 대부분의 실행에서 나오는, 정리할 게 없는 건강한 시스템일 때의 출력입니다.
- 대처
- 별도 조치 필요 없습니다.
- 출처
- src/omm/cli.py
그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로를 첨부해 이슈를 등록하세요.
전체 명령어
- 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 link설치된 모든 모델의 러너 링크를 다시 확인·복구하거나, 커스텀 디렉터리에 링크합니다.
- 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.