내 운영체제에 맞게 설치하고 확인하기

완료하면 할 수 있는 것

• 공식 설치 경로를 선택한다
• 설치·버전·첫 실행을 구분해 확인한다

원리 이해

설치 전에 OS와 CPU, 사용할 계정, 회사 정책을 확인하세요. Windows는 네이티브와 WSL2 두 경로가 있습니다. 네이티브 소스 설치의 Windows 10 지원과 MSIX의 Windows 11 22H2 조건은 다릅니다.

Apple Silicon Mac과 Linux/WSL2는 공식 안내를 따라 준비합니다. Intel Mac은 공식 문서 간 설명이 엇갈리므로 개별 검증 전 지원을 확정하지 않습니다. 처음부터 여러 경로를 중복 설치하지 않습니다.

설치 스크립트는 공식 홈페이지에서 연결되는 주소인지 확인하고 무엇이 설치되는지 읽습니다. 수업용 환경에 설치한 뒤 hermes --version과 hermes doctor를 확인합니다. 버전 출력에는 키가 필요하지 않습니다. 설치 성공 뒤에도 모델 인증이나 선택 도구는 별도로 준비해야 합니다.

위 설치 파일은 현재 공식 배포본을 받습니다. 교육판 후보와 버전이 다르면 기록하고 안내와 대조하세요. Windows 실행 정책 때문에 막히면 조직 정책을 우회하거나 보안을 끄지 말고 공식 Desktop 설치 경로 또는 관리자에게 확인합니다. 아래 Linux 검증은 고정 태그 소스와 uv 잠금파일 설치이며, Windows 설치 스크립트 성공을 보증하지 않습니다.

따라 하기

1. OS·CPU·설치 허가·실습 폴더를 기록한다
2. 공식 지원표에서 배포 방식을 고른다
3. 공식 설치 안내의 해당 OS 절차를 검토하고 본인이 실행한다
4. 새 터미널에서 hermes --version, hermes doctor를 실행한다
5. 모델 연결 후 비밀 없는 sample.txt 하나를 읽어 실제 도구 결과를 확인한다

Windows PowerShell · 공식 설치 파일 검토 후 실행 (이 환경에서 Windows 미실행)

Invoke-WebRequest https://hermes-agent.nousresearch.com/install.ps1 -OutFile hermes-install.ps1
notepad .\hermes-install.ps1
# 내용·공식 출처·설치 정책을 확인한 뒤 실행
.\hermes-install.ps1

Linux / WSL2 / Apple Silicon macOS · 공식 설치 파일 검토 후 실행

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o hermes-install.sh
less hermes-install.sh
# 내용·공식 출처·설치 정책을 확인한 뒤 실행
bash hermes-install.sh

새 터미널에서 설치 단계 확인

hermes --version
hermes --help
hermes doctor

합성 입력·워크시트 받기

실습 프롬프트

현재 실습 폴더의 sample.txt만 읽고 내용을 한 문장으로 요약해 줘. 다른 파일을 찾거나 수정하지 마. 읽기 도구의 성공 여부와 읽은 파일명을 보고해 줘.

프롬프트는 권한 통제를 대신하지 않습니다. 활성 도구와 작업 폴더를 직접 확인하세요.

결과 확인

• 실행 경로와 데이터 경로를 구분한다
• 명령을 찾을 수 있다
• 실제 읽기 결과를 확인한다

가려야 할 비밀이 없는 설치 기록, 실제 버전, 진단 결과, 첫 파일 읽기

막혔을 때

• 명령이 없으면 새 터미널과 PATH를 확인한다
• 기존 데이터 폴더를 삭제해 설치 문제를 해결하지 않는다
• WSL 자료와 Windows 자료의 경로를 혼동하지 않는다

혼자 바꿔 보기

다른 운영체제를 쓰는 동료에게 왜 설치 경로가 다른지 설명한다

근거·다음 행동

• 설치 · 2026-10-05 · 문서 근거, 실기와 별개
• 플랫폼 지원 · 2026-10-05 · 문서 근거, 실기와 별개
• 네이티브 Windows · 2026-10-05 · 문서 근거, 실기와 별개
• Windows WSL2 · 2026-10-05 · 문서 근거, 실기와 별개