지난 2편에서는 로컬 PC용 Ollama 프레임워크와 Node.js/Python 하이브리드 구동 인프라 아키텍처를 설계했습니다.

이번 3편에서는 Nous Research의 'Hermes Agent' 공식 리포지토리 소스를 직접 빌드하고 가상환경을 구축하며, 텔레그램 API 토큰과 로컬/클라우드 AI 두뇌를 매핑해주는 config.json 상세 세팅법을 단계별로 파헤쳐 봅니다. ⚙️

📦 1. 단계별 소스 코드 빌드 및 패키지 설치

터미널(Windows PowerShell 또는 macOS Terminal)을 열고 아래의 순서대로 명령어를 실행해 나만의 비서 형체를 빚어냅니다.

① 공식 Git 리포지토리 클론 및 폴더 이동 📂

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

② Node.js 게이트웨이 종속성 패키지 설치 ⚡

npm install

③ Python 독립 실행용 가상환경(.venv) 셋업 🐍

# 가상환경 생성
python -m venv .venv

# 가상환경 활성화 (Windows)
.venv\Scripts\activate

# 가상환경 활성화 (Mac/Linux)
source .venv/bin/activate

# 의존성 패키지 설치
pip install -r requirements.txt

🔑 2. config.json 커스터마이즈 및 연동 토큰 매핑

복제된 폴더 루트에 config.json 파일을 새로 생성하고, 아래의 템플릿에 맞추어 나만의 연동 토큰 및 AI 모델 경로를 설정합니다.

{
  "agent": {
    "model_provider": "ollama",
    "model_name": "hermes3:8b",
    "ollama_base_url": "http://localhost:11434",
    "use_persistent_memory": true
  },
  "gateways": {
    "telegram": {
      "enabled": true,
      "bot_token": "YOUR_TELEGRAM_BOT_TOKEN_HERE"
    },
    "discord": {
      "enabled": false,
      "bot_token": ""
    }
  },
  "skills": {
    "allow_self_improvement": true,
    "skills_directory": "./skills"
  }
}

💡 설정 꿀팁 (개인 비서 필수 세팅):

  1. YOUR_TELEGRAM_BOT_TOKEN_HERE: 텔레그램에서 @BotFather를 검색해 /newbot 명령어로 나만의 고유 비서 봇을 생성하고 발급받은 API 토큰을 정확히 입력합니다.
  2. allow_self_improvement: true: 이 옵션이 켜져 있어야 에이전트가 본인의 문제 해결 스킬을 스스로 발명해 로컬 파일 시스템에 코드로 적재하는 혁신 기능이 활성화됩니다.

🏁 다음 편 예고: Part 4. 실무 비서 서비스 구현 및 자율 스킬 구동

다음 4편에서는 모든 셋업이 완료된 Hermes Agent를 최초로 기동하고, 모바일 텔레그램 메신저를 통해 실시간 개인 비서 서비스를 구동하며, 에이전트가 스스로 스킬을 학습하여 일일 이메일 요약 및 자동화를 완성하는 기적의 실무 시나리오를 전격 가동하겠습니다! 💡