Mac에서 Hermes Agent를 가장 간단하게 시작하려면 공식 Hermes Desktop 설치 파일을 이용하면 됩니다. 터미널만 쓰고 싶다면 공식 설치 스크립트를 실행한 뒤 모델을 연결하고, 기본 대화가 정상 작동하는지 확인하세요.
이 글은 Apple Silicon Mac에서 설치부터 첫 대화까지 확인하는 순서에 집중합니다. Discord·Telegram 연결과 자동화는 기본 대화가 된 다음에 진행합니다.
- 내 Mac이 현재 공식 지원 범위인지 확인하는 법
- Desktop 설치와 명령줄 설치 중 고르는 기준
- 설치 후 모델 연결·첫 대화·진단 순서
- 자주 생기는 오류와 비밀값·권한 관리 원칙
설치 전에 무엇을 확인하나요?
2026년 8월 현재 공식 지원표에서 macOS의 우선 지원 대상은 Apple Silicon입니다. Intel Mac은 지원하지 않는 설치 환경으로 안내되어 있으므로, 먼저 프로세서 종류를 확인해야 합니다.
| 확인 항목 | 확인 방법 | 판단 |
|---|---|---|
| 프로세서 | 메뉴 → 이 Mac에 관하여 또는 터미널에서 uname -m |
arm64라면 Apple Silicon |
| 설치 경로 | 화면 중심 사용 또는 터미널 중심 사용 | 처음이라면 Hermes Desktop이 간단함 |
| 모델 연결 | Nous Portal 또는 지원되는 모델 제공자 계정 | 설치 뒤 hermes setup에서 선택 |
| 민감정보 | API 키·OAuth·봇 토큰 보관 위치 | 공개 문서·채팅·스크린샷에 노출하지 않음 |
| 원본 보호 | AI가 접근할 작업 폴더와 백업 | 처음에는 테스트 폴더만 허용 |
공식 문서에 없는 Homebrew·PyPI 설치법은 피하는 편이 좋습니다.
현재 공식 지원표는 brew install과 pip install 계열을 지원하지 않는 배포 방식으로 분류합니다. 오래된 블로그 명령보다 공식 설치 페이지를 우선하세요.
Hermes Agent의 개념과 활용 범위를 먼저 보고 싶다면 Hermes Agent란 무엇인가요?에서 설치형 에이전트와 비스타의 AI 동료 운영 방식을 확인할 수 있습니다.
Hermes Desktop과 터미널 설치 중 무엇을 고르나요?
| 방법 | 잘 맞는 사람 | 특징 |
|---|---|---|
| Hermes Desktop | 터미널 설치가 낯설고 화면에서 시작하고 싶은 사람 | 공식 사이트의 Mac 설치 파일을 실행하며 CLI와 Desktop 앱을 함께 설치하는 권장 경로 |
| 공식 설치 스크립트 | 터미널 중심으로 사용하고 설치 과정을 직접 확인할 사람 | 명령 한 줄로 의존성과 실행 환경을 구성하는 경로 |
처음 사용하는 비개발자라면 Desktop으로 시작해도 됩니다. 이 글의 다음 절차는 명령줄 설치를 선택했을 때 확인할 내용을 설명합니다.
터미널에서 Hermes Agent를 어떻게 설치하나요?
1. 공식 주소를 다시 확인합니다
설치 명령은 외부 스크립트를 내려받아 실행합니다. 주소가 hermes-agent.nousresearch.com인지 확인하고, 가능하면 공식 GitHub의 설치 스크립트도 함께 확인하세요.
2. 공식 설치 명령을 실행합니다
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash공식 설치기는 필요한 Python·Node.js·ripgrep·ffmpeg와 가상환경, Hermes 실행 명령을 구성합니다. Mac에서는 Git이 준비되어 있어야 하며, 설치기가 필요한 항목을 점검합니다.
3. 터미널을 새로 열거나 셸 설정을 다시 읽습니다
source ~/.zshrcMac 기본 셸이 zsh인 경우 위 명령을 쓰거나 터미널 창을 새로 열면 됩니다. 설치 직후 hermes: command not found가 보인다면 가장 먼저 이 단계를 확인합니다.
설치 뒤 첫 대화는 어떻게 확인하나요?
설치가 끝났다고 메신저와 자동화를 바로 붙이지 마세요. 모델 연결 → 기본 대화 → 진단 순서로 하나씩 확인해야 문제가 생겨도 원인을 찾기 쉽습니다.
1. 기본 설정 또는 모델 연결
hermes setup
# 또는 Nous Portal을 사용할 때
hermes setup --portal
# 나중에 모델만 바꿀 때
hermes modelhermes setup은 전체 설정을 안내하고, hermes model은 사용할 모델 제공자를 선택하거나 바꿀 때 씁니다. 제공자별 인증 방식과 요금은 서로 다르므로 공식 문서와 해당 서비스의 현재 안내를 확인하세요.
2. 첫 대화
hermes첫 요청은 결과를 확인하기 쉬운 작은 일로 정합니다. 예를 들어 “현재 폴더에서 파일 이름만 읽고 세 줄로 설명해줘”처럼 읽기 중심 작업으로 시작하세요.
3. 설치 진단
hermes doctor모델 인증이나 설정이 잘못됐다면 먼저 hermes model을 다시 실행하고, 기본 대화가 정상인지 확인합니다.
| 명령 | 용도 | 언제 쓰나 |
|---|---|---|
hermes |
대화 시작 | 설치와 모델 연결 뒤 첫 확인 |
hermes setup |
전체 설정 마법사 | 처음 구성하거나 큰 설정을 다시 볼 때 |
hermes model |
모델 제공자와 모델 선택 | 응답이 없거나 모델을 바꿀 때 |
hermes tools |
사용할 도구 설정 | 기본 대화가 된 뒤 필요한 권한만 고를 때 |
hermes doctor |
환경과 설정 진단 | 설치·인증 문제가 의심될 때 |
hermes update |
설치 방식에 맞춰 업데이트 | 공식 변경사항을 확인한 뒤 갱신할 때 |
hermes --continue |
최근 대화 이어가기 | 세션 저장이 정상인지 확인할 때 |
스킬과 메모리는 언제 설정하나요?
첫 대화가 정상인 다음에 추가합니다. 스킬은 반복 작업의 절차를 담은 문서이고, 메모리는 다음 대화에서 다시 써야 할 사용자 기준과 환경 정보를 남기는 기능입니다.
모든 대화와 파일을 무조건 기억하게 만드는 것이 목표는 아닙니다. 다음에도 써야 할 기준만 남기고, 개인정보·고객 자료·API 키는 기억 파일에 넣지 않는 원칙이 필요합니다.
Discord·Telegram 연결은 언제 하나요?
공식 Quickstart도 기본 대화가 작동한 뒤 게이트웨이를 추가하라고 안내합니다. 메신저부터 연결하면 모델 문제와 봇 권한 문제를 구분하기 어렵습니다.
hermes gateway setup
hermes gateway statushermes gateway setup에서 사용할 플랫폼을 선택하고, 연결 뒤에는 hermes gateway status로 상태를 확인합니다. 백그라운드 서비스로 운영할 때의 start·install 명령은 macOS와 실행 방식에 따라 달라질 수 있으므로 현재 Messaging Gateway 문서를 따라야 합니다.
봇 토큰은 비밀번호와 같습니다. 스크린샷, 공개 채팅, WordPress 본문에 붙여넣지 말고 Hermes가 안내하는 비밀값 저장 위치를 이용합니다.
처음에는 어떤 일을 맡기면 좋나요?
- 테스트 폴더의 파일 목록 읽기
- 이미 있는 문서를 요약하고 원문과 대조하기
- 반복 체크리스트 한 개를 스킬로 정리하기
- 사람의 검토가 필요한 초안 만들기
- 결과와 오류가 안정된 뒤 메신저·예약 작업 추가하기
설치의 완료 기준은 명령이 한 번 실행된 것이 아니라, 작은 실제 작업을 수행하고 결과를 사람이 확인할 수 있는 상태입니다.
문제가 생기면 무엇부터 확인하나요?
| 증상 | 먼저 확인할 것 | 다음 행동 |
|---|---|---|
hermes: command not found |
터미널을 새로 열었는지, 셸 설정을 다시 읽었는지 | source ~/.zshrc 후 다시 실행 |
| Hermes는 열리지만 답하지 않음 | 모델 제공자·모델·인증 | hermes model을 다시 실행 |
hermes doctor가 설정 오류를 표시 |
누락되거나 오래된 설정 | 표시된 항목을 고친 뒤 기본 대화부터 재시험 |
| Gateway가 열렸지만 봇이 반응하지 않음 | 봇 토큰·허용 목록·플랫폼 설정 | hermes gateway setup 재실행 후 상태 확인 |
| 업데이트 후 설정이 이상함 | 공식 변경사항과 설정 검사 | hermes config check 후 필요하면 마이그레이션 |
오류 화면을 공유할 때 비밀값을 먼저 가리세요.
API 키, OAuth 토큰, 봇 토큰, 사용자 폴더 경로, 고객 파일 이름이 터미널 출력에 포함될 수 있습니다.
공식 참고자료
자주 묻는 질문
Q1. Mac에서 Hermes Agent를 설치할 때 Desktop과 터미널 중 무엇이 쉬운가요?
처음 사용하는 비개발자라면 공식 Hermes Desktop 설치 경로가 간단합니다. 터미널 중심으로 운영하고 설치 과정을 직접 확인하려면 공식 설치 스크립트를 사용할 수 있습니다.
Q2. Intel Mac에도 Hermes Agent를 설치할 수 있나요?
현재 공식 플랫폼 지원표는 macOS의 우선 지원 대상을 Apple Silicon으로 두고 Intel Mac을 지원하지 않는 환경으로 분류합니다. 설치 전에 프로세서를 확인하세요.
Q3. 설치 후 가장 먼저 실행할 명령은 무엇인가요?
전체 설정은 hermes setup, 모델 선택은 hermes model로 진행한 뒤 hermes로 첫 대화를 확인합니다. 문제가 있으면 hermes doctor를 실행합니다.
Q4. Discord나 Telegram을 바로 연결해도 되나요?
먼저 터미널에서 기본 대화가 정상 작동하는지 확인하는 편이 좋습니다. 그다음 hermes gateway setup으로 플랫폼을 연결해야 모델 문제와 봇 권한 문제를 구분하기 쉽습니다.
Q5. API 키와 봇 토큰은 어디에 적어야 하나요?
공개 문서나 채팅에 적지 말고 Hermes 설정 과정이 안내하는 비밀값 저장 위치를 사용하세요. 오류 화면을 공유할 때도 키와 토큰을 먼저 가려야 합니다.
AI를 내 업무에 어떻게 붙일지 궁금하다면
비스타 AI 웨비나와 다음 안내를 카카오톡 오픈채팅방에서 확인할 수 있습니다. 입장 비밀번호는 together입니다.
이 글은 김인숙 대표의 Mac mini 운영 경험과 Hermes Agent 공식 문서를 바탕으로 작성하고 다시 검토했습니다.
업데이트: 2026년 8월 9일 — 공식 설치 주소, Apple Silicon 지원 범위, Desktop 권장 경로, 현재 CLI 명령과 오류 점검 순서를 최신 문서에 맞춰 수정했습니다. 설치·지원 정보는 월 1회 다시 확인합니다.
