Windows에 omm 설치하기

01 / 08 · Windows

PowerShell 열기

omm의 Windows 설치 스크립트는 PowerShell 스크립트입니다. Command Prompt에서는 실행되지 않고, Git Bash나 WSL 셸에서도 마찬가지입니다 — 둘 다 Unix 셸이라 PowerShell 명령을 이해하지 못합니다.

• Windows 키를 누르고 PowerShell을 입력해 Windows PowerShell을 여세요. Windows에 기본 내장된 Windows PowerShell 5.1과 PowerShell 7 모두 문제없이 쓸 수 있습니다.

• Windows Terminal을 창으로 써도 괜찮지만 탭은 꼭 확인하세요: 더하기 기호 옆 화살표를 눌러 Command Prompt가 아니라 Windows PowerShell 또는 PowerShell을 선택해야 합니다.

• omm을 설치하는 데 관리자 권한은 필요 없습니다.

지금 무엇을 열어 놓았는지 헷갈린다면 줄 맨 앞의 프롬프트를 보세요.

• PS C:\Users\you>PowerShell — 이 창을 쓰세요
• C:\Users\you>이 창은 아닙니다 — Command Prompt — 여기서는 설치 명령이 동작하지 않습니다
• you@PC MINGW64 ~$이 창은 아닙니다 — Git Bash — 여기서도 설치 명령이 동작하지 않습니다

• Windows 10 22H2 또는 Windows 11이 지원 기준입니다. Ollama가 Windows에서 요구하는 조건을 그대로 따른 것입니다.

02 / 08 · Windows

시작하기 전에

설치 스크립트는 필요한 것을 알아서 받아 오지만, 그중 두 가지 자동 설치 과정은 winget이 있어야만 동작합니다.

• Python 3.10+

  필수입니다. PATH에 적합한 Python이 없으면 설치 스크립트가 winget에 Python 3.12 설치를 요청한 뒤 다시 확인합니다.

  • python.org/downloads
• git

  필수입니다. omm은 검증된 Git 체크아웃으로부터 설치되기 때문입니다. git이 없으면 설치 스크립트가 winget에 MinGit을 요청합니다.

  • git-scm.com/downloads
• winget

  Windows 10 2004 이상과 Windows 11에는 기본 내장돼 있습니다. 그보다 이전 버전에는 없으므로, Python 3.10+와 git을 먼저 직접 설치해야 합니다 — 설치 스크립트가 대신해 줄 수 없는 부분입니다.

  • winget documentation
  • python.org/downloads
  • git-scm.com/downloads
• Windows baseline

  omm은 Windows, macOS, Linux에서 Python 3.10+ 기준으로 테스트됩니다. Windows 10 22H2 / 11이 지원되는 Windows 기준입니다.
• NVIDIA extra

  선택적인 NVIDIA 감지 기능은 nvidia-smi가 NVIDIA 드라이버의 존재를 확인해 줄 때만 설치됩니다. 어느 쪽이든 따로 할 일은 없습니다.

03 / 08 · Windows

설치

세미콜론 앞부분까지 포함한 줄 전체를 PowerShell에 붙여넣고 Enter를 누르세요.

PS > [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; irm https://omm.run/install.ps1 | iex

• 앞부분은 생략할 수 없습니다. 반드시 irm보다 먼저 실행돼야 합니다. 스크립트 내부에서 TLS를 설정해서는 이미 늦습니다 — PowerShell이 스크립트의 첫 줄을 읽는 시점에는 다운로드 자체가 이미 끝난 뒤이기 때문입니다.
• irm은 스크립트를 내려받고 iex는 이를 실행합니다. 둘 다 PowerShell 명령이라 탭이 반드시 PowerShell이어야 하는 이유이기도 합니다.
• 설치 후에는 새 PowerShell 창을 열어야 PATH에 omm이 반영됩니다.

PS > python -m pip install omm-model

PS > pipx install omm-model

04 / 08 · Windows

설치 스크립트가 하는 일

한 줄짜리 설치 스크립트는 그냥 내려받아 실행하는 게 아닙니다. 세 단계를 순서대로 거치며, 가져온 코드가 omm이 서명한 코드와 다르면 두 번째 단계에서 곧바로 멈춥니다.

1. 01스테이징 클론 — 릴리스는 버전이 붙은 스테이징 디렉터리에 클론되며, 지금 실행 중인 사본을 덮어쓰는 일은 없습니다.
2. 02서명된 커밋 검증 — 스테이징된 커밋은 어느 부분이든 실행되기 전에 부트스트랩 신뢰 앵커와 먼저 대조해 검증합니다.
3. 03pipx 전환 — 이 검증을 통과한 뒤에야 pipx가 스테이징된 트리로 전환하므로, omm은 계속 격리된 CLI로 남습니다.

커밋의 진위가 중요하다면 이 과정을 검증 없는 git clone과 pipx install로 대체하지 마세요.

05 / 08 · Windows

설치한 다음

설치 스크립트의 마지막 줄은 Done.입니다. 그런데도 'omm' isn't found가 뜬다면 새 셸을 여세요. pipx가 방금 PATH를 갱신했을 뿐이니, 말 그대로 창만 새로 열면 됩니다.

1. 01

   새 PowerShell 창 열기

   pipx가 bin 디렉터리를 PATH에 추가하긴 했지만, 이미 열려 있던 창은 시작할 때의 PATH를 그대로 유지합니다. 창을 닫고 새로 여세요.

2. 02

   omm을 한 번 실행하기

   막 설치를 마친 상태에서 인자 없이 omm만 실행하면 설정 마법사가 시작됩니다. 하드웨어 요약이 먼저 나오고, 이어서 로컬 AI 러너 체크리스트가 뜹니다. omm이 Windows에서 설치할 수 있는 항목을 체크하면 실시간 진행 상황과 함께 공식 설치 프로그램이 실행되고, 자동으로 설치할 수 없는 항목을 체크하면 대신 다운로드 링크가 출력됩니다. omm setup으로 언제든 다시 실행할 수 있습니다.

   PS > omm

   복사
3. 03

   omm이 인식하는 내용 확인하기

   omm scan은 앞으로의 모든 적합성 판단이 근거로 삼을 하드웨어, 러너, 모델 요약을 출력합니다.

   PS > omm scan

   복사

                      omm hardware scan
┌───────────────────────┬───────────────────────────────────┐
│ Field                 │ Value                             │
├───────────────────────┼───────────────────────────────────┤
│ OS                    │ Windows 11                        │
│ CPU                   │ Intel(R) Core(TM) Ultra 7 155H    │
│ RAM (total)           │ 15.5 GB                           │
│ RAM (available)       │ 0.7 GB                            │
│ Safe model budget now │ 0.0 GB                            │
│ Reserved for apps/OS  │ 1.6 GB+                           │
│ GPU                   │ Intel(R) Arc(TM) Graphics         │
│ VRAM                  │ Shared or unavailable from the OS │
└───────────────────────┴───────────────────────────────────┘

  Local AI runners
 Program  Status
 Ollama   installed
+ 6 program(s) not installed

06 / 08 · Windows

Windows의 러너

omm은 모델마다 중앙에 사본 하나만 두고, 이를 찾아낸 모든 러너에 링크합니다. 설정 마법사는 이 러너 중 일부를 대신 설치해 주는데, 어떤 것이 가능한지는 운영체제에 따라 갈립니다. 각 제조사가 공식 지원하는 패키지만 쓰기 때문입니다.

• Ollama자동 설치
• LM Studio자동 설치 — headless lms CLI
• Jan자동 설치 — winget
• KoboldCpp64비트 x86(AMD64)에서 자동 설치
• text-generation-webui64비트 x86에서 자동 설치
• AnythingLLM64비트 x86(AMD64)에서 자동 설치
• Msty64비트 x86(AMD64)에서 자동 설치

• AnythingLLM도 Msty Studio도 winget 패키지가 없습니다 — AnythingLLM의 커뮤니티 매니페스트는 2025년에 철회됐고, Msty Studio는 단종된 이전 버전용 winget 패키지만 있을 뿐 현재 앱을 겨냥한 것은 없습니다. 대신 64비트 Windows에서는 omm이 각 제조사의 공식 설치 프로그램을 직접 내려받아 조용히 실행합니다. ARM Windows에서는 다운로드 링크만 출력합니다.
• 이미 설치된 러너도 마법사 목록에 빠짐없이 나타납니다. 숨기지 않고 installed로 표시하므로, 체크리스트는 항상 omm이 실제로 감지한 상태를 그대로 반영합니다.
• Windows에서는 Ollama를 HTTP API로 먼저 감지하므로, 방금 설치된 트레이 앱도 이 터미널이 새 PATH를 받기 전에 이미 잡힙니다.

07 / 08 · Windows

저장 위치, 자동 완성, 제거

모델이 저장되는 위치

모델 허브와 omm 자체 상태는 기본적으로 사용자 프로필 안의 .omm 폴더에 저장됩니다. 다른 드라이브에 두려면 설치 전과 이후 실행 시 모두 OMM_HOME을 설정하세요.

PS > [Environment]::SetEnvironmentVariable("OMM_HOME", "D:\omm", "User")

PS > $env:OMM_HOME = "D:\omm"

• Ollama 자체의 모델 위치는 OLLAMA_MODELS를 따릅니다. LM Studio는 자체 home 포인터를 따르므로, LM Studio가 omm이 찾을 수 없는 사용자 지정 디렉터리를 쓰고 있다면 OMM_LMSTUDIO_MODELS_DIR을 설정하세요.

셸 자동 완성

셸 자동 완성은 한 번만 설치하면 됩니다. 설치 후 셸을 재시작하세요.

PS > omm --install-completion powershell

제거

이 작업은 omm 명령과, 설치 스크립트가 관리하던 소스 체크아웃을 제거합니다. OMM_HOME 아래의 다운로드된 모델과 설정은 그대로 남습니다.

PS > irm https://omm.run/uninstall.ps1 | iex

• 모델 허브와 설정까지 함께 지우려면 스크립트를 내려받아 -Purge와 함께 실행하세요. Purge는 omm 소유로 확인된 경로만 지우고, 사용자 지정 OMM_HOME 안의 무관한 파일은 건드리지 않습니다.
• 설치 스크립트는 사용자 지정 홈 디렉터리에 표시를 남겨 두어, 제거 스크립트가 모호하거나 안전하지 않은 위치는 건드리지 않고 거부할 수 있게 합니다. 제거하는 동안 셸 프로필을 다시 쓰는 일은 절대 없습니다.
• PyPI로 설치했다면 대신 python -m pip uninstall omm-model 또는 pipx uninstall omm-model을 쓰세요. 둘 다 모델과 설정을 보존합니다.

08 / 08 · Windows

문제가 생겼다면

아래 메시지는 모두 설치 스크립트, 제거 스크립트, 셸이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.

1. sh : The term 'sh' is not recognized as the name of a cmdlet, function, script file, or operable program.

   원인

   PowerShell에 macOS·Linux용 명령(curl … | sh가 들어간 명령)을 붙여넣었습니다. PowerShell에는 sh가 없습니다.

   대처

   대신 이 페이지 3단계의 Windows용 명령을 쓰세요. 두 운영체제는 같은 명령을 다르게 표기한 게 아니라, 아예 서로 다른 명령을 씁니다.

   출처

   README, Install section — two separate installer commands

2. Windows detected. Run the native PowerShell installer instead:

   원인

   Unix용 설치 스크립트가 Git Bash, MSYS 또는 Cygwin에서 실행됐습니다. 이 경우 스크립트는 자신이 Windows 위에 있다는 걸 감지하고, 어설프게 설치를 진행하는 대신 아예 거부합니다.

   대처

   1단계대로 PowerShell을 열고 Windows용 명령을 실행하세요. 메시지 자체에도 올바른 명령이 함께 출력됩니다.

   출처

   install.sh:27-32

3. 'irm' is not recognized as an internal or external command, operable program or batch file.

   원인

   지금 Command Prompt에 있습니다. irm과 iex는 PowerShell 명령입니다.

   대처

   PowerShell을 여세요. Windows Terminal이라면 더하기 기호 옆 화살표로 PowerShell 탭을 새로 시작하면 됩니다.

   출처

   README, Install section — the command is PowerShell-only

4. Invoke-RestMethod : The request was aborted: Could not create SSL/TLS secure channel.

   원인

   Windows PowerShell 5.1은 기본값으로 GitHub가 더 이상 허용하지 않는 TLS 버전을 씁니다. irm이 먼저 스크립트를 내려받아야 하는 구조라, 스크립트 내부에서는 이 문제를 스스로 해결할 수 없습니다.

   대처

   irm 앞의 [Net.ServicePointManager] 부분까지 포함한 줄 전체를 실행하세요. 그래도 실패한다면 회사 프록시나 HTTPS를 들여다보는 백신 프로그램이 연결을 가로채고 있는 것이니, 다른 네트워크에서 시도해 보세요.

   출처

   install.ps1:1-5 (header comment); README Windows caveat

5. Python not found. Install Python 3.10+ first: https://www.python.org/downloads/

   원인

   Python 3.10 이상을 찾지 못했고, winget이 없거나 설치 시도가 실패했습니다.

   대처

   python.org에서 Python을 설치하며 Add python.exe to PATH를 체크하고, 새 PowerShell 창을 연 뒤 설치 명령을 다시 실행하세요.

   출처

   install.ps1:220

6. git not found. Install git first (needed to fetch omm from GitHub): https://git-scm.com/downloads

   원인

   git도 상황은 같습니다. omm은 검증된 Git 체크아웃으로부터 설치되므로 git이 반드시 있어야 합니다.

   대처

   링크된 페이지에서 git을 설치하고, 새 PowerShell 창을 연 뒤 설치 명령을 다시 실행하세요.

   출처

   install.ps1:232 and install.ps1:237

7. git 2.34+ is required to verify SSH commit signatures (found git version 2.30.0).

   원인

   git 버전이 너무 오래되어 SSH 커밋 서명을 확인할 수 없습니다. 설치 스크립트는 이런 '검증 불가' 상태를 서명 오류와 똑같이 취급합니다.

   대처

   git을 업데이트한 뒤 설치 명령을 다시 실행하세요.

   출처

   install.ps1:105

8. Signature verification failed - refusing to install untrusted code.

   원인

   스테이징된 커밋이 설치 스크립트의 신뢰 앵커에 등록된 키로 서명되지 않았거나, 앞 항목처럼 git이 서명 자체를 확인하지 못한 경우입니다.

   대처

   git을 업데이트한 뒤 다시 시도하세요. 그래도 실패한다면 일반 git clone으로 우회하지 말고, 대신 저장소에 이슈를 등록하세요.

   출처

   install.ps1:585

9. git clone failed.

   원인

   스테이징 클론이 github.com에 접속하지 못했습니다. 대개 프록시, 방화벽, 또는 네트워크 자체가 없는 경우입니다.

   대처

   이 기기의 브라우저에서 github.com이 열리는지 먼저 확인한 뒤 설치 명령을 다시 실행하세요.

   출처

   install.ps1:561

10. Refusing to replace pipx environment 'omm': it is not an omm install this installer recognises. Run 'pipx uninstall omm', then re-run this installer.

    원인

    omm이라는 이름의 pipx 환경이 이미 있는데, 설치 스크립트가 이를 omm 설치로 인식하지 못합니다 — 대개 설치 이후 OMM_HOME이 옮겨졌거나, 그 소스 체크아웃이 삭제된 경우입니다. 어느 쪽이든 OMM_HOME 아래의 모델과 설정은 영향받지 않습니다.

    대처

    pipx uninstall omm을 실행한 뒤 설치 명령을 다시 실행하세요.

    출처

    install.ps1:536-538

11. Refusing to replace an unverified omm-model pipx environment.

    원인

    omm-model이라는 pipx 환경은 있지만, omm이 만든 것으로 보이지 않습니다.

    대처

    pipx uninstall omm-model을 실행한 뒤 설치 명령을 다시 실행하세요.

    출처

    install.ps1:546

12. Refusing unsafe OMM_HOME: C:\Users\you

    원인

    OMM_HOME이 드라이브 루트나 사용자 프로필 자체를 가리키고 있습니다. 그런 위치는 안전하게 제거할 방법이 없습니다.

    대처

    OMM_HOME이 D:\omm처럼 하위 디렉터리를 가리키도록 바꾸세요. Refusing OMM_HOME that contains the current directory라는 관련 메시지가 뜬다면, 지금 그 폴더 안에 있다는 뜻이니 먼저 다른 곳으로 cd하세요.

    출처

    install.ps1:13

13. omm : The term 'omm' is not recognized as the name of a cmdlet …

    원인

    설치는 끝났지만, 이 창은 여전히 시작할 때의 PATH를 그대로 갖고 있습니다.

    대처

    새 PowerShell 창을 여세요. 설치 스크립트도 마지막 줄에 같은 안내를 출력합니다.

    출처

    PowerShell — the new PATH from this install has not loaded into the current session yet

14. Refusing unrecognized custom OMM_HOME (missing .omm-managed): D:\omm

    원인

    설치 스크립트가 한 번도 자신의 것으로 표시한 적 없는 사용자 지정 OMM_HOME에서 제거를 시도하고 있어, 제거 스크립트가 그 폴더를 건드려도 안전한지 확신할 수 없습니다.

    대처

    OMM_HOME이 omm이 실제로 설치된 폴더를 가리키는지 확인한 뒤, 제거 스크립트를 다시 실행하세요.

    출처

    uninstall.ps1:21

그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로와 omm scan 출력을 함께 첨부해 이슈를 등록하세요.