에이전트에 스킬 넣기

터미널이 무엇입니까

터미널은 프로그램에 명령을 글자로 건네는 창입니다. 아이콘을 눌러 여는 대신 이름을 적어 실행한다고 생각하시면 됩니다. 검은 배경에 글자만 있어서 위험해 보이지만, 하는 일은 파일을 열고 프로그램을 설치하는 것뿐이고, 적지 않은 일은 일어나지 않습니다.

창을 열면 이런 줄이 하나 보입니다.

jk@macbook ~ %

이 줄을 프롬프트라고 부릅니다. "명령을 기다리는 중"이라는 뜻입니다. 끝의 기호는 컴퓨터마다 % 또는 $이고, 그 뒤에 명령을 적고 엔터를 치면 됩니다.

여는 법. macOS는 Command+스페이스를 눌러 "터미널"을 검색해 엽니다. Windows는 시작 메뉴에서 "PowerShell"을 검색해 엽니다. 이 레슨은 두 경우를 모두 안내합니다.

1. Hermes 설치

Hermes Agent는 내 폴더에서 직접 읽고 쓰는 에이전트입니다. 프로그램 자체는 무료이고 MIT 라이선스입니다.

macOS 또는 Linux(그리고 WSL2):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows는 PowerShell에서:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

설치에는 몇 분이 걸리고, 화면에는 내려받는 항목들이 줄줄이 흐릅니다. 설치 프로그램이 Python과 uv 같은 필요한 것들을 알아서 함께 넣기 때문에 따로 준비할 것은 없습니다. 마지막 줄까지 흐르고 프롬프트가 다시 나타나면 끝난 것입니다.

2. 셸을 다시 읽기

설치 직후에 hermes를 실행하면 "command not found"가 나오는 경우가 많습니다. 고장이 아니라, 열려 있던 창이 방금 설치된 프로그램의 위치를 아직 모르기 때문입니다. macOS·Linux에서는 다음 한 줄로 해결됩니다.

source ~/.bashrc

macOS 기본 셸은 zsh이므로 source ~/.zshrc가 맞는 경우도 있습니다. 둘 중 하나가 듣지 않으면 터미널 창을 닫고 새로 여십시오. Windows PowerShell도 창을 새로 열면 됩니다.

3. 제공자와 키 넣기 — 여기가 두 번째 절벽입니다

Hermes는 무료이지만, AI 모델을 호출하는 값은 제공자에게 따로 붙습니다. 그래서 제공자 한 곳의 계정과 키가 필요합니다. 설정 마법사가 이 과정을 순서대로 물어봅니다.

hermes setup

모델과 제공자만 다시 고르고 싶을 때는 이 명령을 씁니다.

hermes model

키 같은 비밀 값은 ~/.hermes/.env에, 나머지 설정은 ~/.hermes/config.yaml에 저장됩니다. 두 파일 다 내 컴퓨터 안에 있습니다.

4. 문헌 검색 스킬 넣기

두 줄입니다. 첫 줄은 이 저장소를 스킬 목록에 등록하고, 둘째 줄이 실제로 설치합니다.

hermes skills tap add junhewk/hermes-medical-search
hermes skills install junhewk/hermes-medical-search/skills/medical-literature-search

설치되는 것은 앞 레슨에서 읽어 본 그 절차서입니다. 스킬은 필요할 때만 검색 프로그램을 잠깐 불러 쓰고 끝내므로, 배경에 계속 도는 서버가 남지 않습니다.

5. 들어갔는지 확인하기

hermes skills list

목록에 medical-literature-search가 한 줄 늘어나 있으면 된 것입니다. 설치는 이번 한 번뿐이고, 다음부터는 한국어로 요청만 하면 됩니다.

막히면 보는 표

증상	원인	해결
hermes: command not found	창이 새 프로그램의 위치를 아직 모름	source ~/.bashrc(또는 ~/.zshrc) 실행, 안 되면 터미널을 닫고 새로 열기
스킬 목록에 안 보임	설치 명령이 끝까지 진행되지 않음	hermes skills list로 다시 확인하고, 안 보이면 4번의 두 줄을 순서대로 다시 실행
설치 두 줄이 오류로 끝남	저장소 주소나 스킬 경로가 바뀌었을 수 있음	저장소 README의 현재 설치 명령을 확인. Hermes Desktop을 쓰신다면 Skills 화면의 Learn a skill에 저장소 주소를 붙여 넣는 방법도 있습니다
대화는 되는데 검색이 안 돎	제공자 키가 안 들어감	hermes model로 제공자와 모델을 다시 확인
무엇이 문제인지 모르겠음	—	hermes doctor를 실행하면 어디가 어긋났는지 점검해 줍니다
Windows에서 백신이 uv.exe를 격리함	서명 없는 설치 도구에 대한 오탐	Hermes README의 검증·예외 처리 안내를 따르십시오

직접 해 보기약 25분

위의 다섯 걸음을 한 번에 하나씩 밟습니다. 마지막에 hermes skills list를 실행해 나온 화면을 그대로 복사해 두십시오.

남는 것은 그 목록 출력입니다. 성공했든 중간에 막혔든 커뮤니티에 올려 주십시오. 막혔다면 무엇을 하려다 어느 줄에서 멈췄는지와 화면에 나온 문장을 그대로 적어 주시면 됩니다.

커뮤니티에 결과를 남겨 보세요

연구에 적용하면

지금 한 일은 프로그램 하나를 깐 것이 아니라, 연구실의 검색 절차를 실행 가능한 형태로 들여놓은 것입니다. 같은 두 줄을 동료의 컴퓨터에서 실행하면 같은 절차가 들어갑니다. 누가 실행해도 같은 형식의 결과가 나오고 그 과정이 파일로 남습니다. 터미널을 다시 열 일은 생각보다 적습니다. 다음 레슨부터는 대부분 한국어 문장으로 일합니다.