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://raw.githubusercontent.com/omm-hippo/omm/main/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에서 자동 설치
• AnythingLLM수동 — 직접 설치하면 omm이 그대로 링크합니다
• Msty수동 — 직접 설치하면 omm이 그대로 링크합니다

• 여기서 수동은 마법사가 제조사의 설치 프로그램을 대신 실행해 주지 않는다는 뜻일 뿐입니다. 다운로드 링크를 출력해 주며, 앱이 존재하기만 하면 omm은 다른 러너와 마찬가지로 이를 감지하고 링크합니다.
• AnythingLLM은 더 이상 winget 패키지가 없습니다 — 커뮤니티 매니페스트가 2025년에 철회되었습니다 — 그리고 현재의 Msty Studio 앱을 대상으로 하는 winget 패키지도 없고, 있는 것은 단종된 이전 버전용뿐입니다. 이런 이유로 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://raw.githubusercontent.com/omm-hippo/omm/main/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:217

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:229 and install.ps1:234

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:553

9. git clone failed.

   원인

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

   대처

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

   출처

   install.ps1:529

10. Refusing to replace unrelated pipx environment 'omm'. Remove or rename that environment manually first.

    원인

    omm이라는 이름의 무관한 다른 PyPI 프로젝트가 이미 해당 pipx 환경을 점유하고 있습니다. 설치 스크립트는 다른 도구를 덮어쓰지 않습니다.

    대처

    그 다른 도구가 필요 없다면 pipx uninstall omm을 실행하거나 해당 환경의 이름을 변경한 뒤, 설치 명령을 다시 실행하세요.

    출처

    install.ps1:506

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

    원인

    omm-model pipx 환경이 존재하지만 omm이 생성한 것으로 보이지 않습니다.

    대처

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

    출처

    install.ps1:514

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 and install.ps1:18

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

    원인

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

    대처

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

    출처

    install.ps1:671

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

    원인

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

    대처

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

    출처

    uninstall.ps1:21

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