Hermes AI 에이전트 구축 가이드: VPS 세팅부터 텔레그램 연동까지
나만의 똑똑한 비서를 클라우드에 24시간 내내 구동할 수 있다면 어떨까요? 최근 인공지능 분야에서 가장 주목받는 'AI 에이전트'는 단순한 챗봇을 넘어 스스로 판단하고 작업을 수행하는 자율성을 가지고 있습니다. 특히 오픈소스 기반의 Hermes AI 에이전트는 강력한 성능과 유연한 커스터마이징 성능으로 개발자와 얼리어답터 사이에서 큰 인기를 끌고 있습니다. 본 가이드에서는 가상 사설 서버(VPS) 호스팅 설정부터 SSH 터미널 접속을 통한 패키지 빌드, 그리고 최종적으로 일상에서 가장 편리하게 사용할 수 있는 텔레그램(Telegram) 메신저 연동까지의 전 과정을 초보자도 쉽게 따라 할 수 있도록 상세히 정리했습니다. 이제 나만의 인공지능 비서를 직접 구축해 보세요.
1단계: VPS 호스팅 준비하기
AI 에이전트가 중단 없이 안정적으로 작동하기 위해서는 365일 24시간 구동되는 가상 사설 서버(VPS)가 필수적입니다. 로컬 컴퓨터를 계속 켜두는 것보다 클라우드 VPS를 활용하는 것이 전력 소모나 네트워크 안정성 측면에서 훨씬 유리합니다. 본격적인 Hermes AI 세팅에 앞서 고성능 가상 서버 호스팅을 먼저 준비해야 합니다.
성공적인 에이전트 구동을 위해 최소 Ubuntu 22.04 LTS 이상의 운영체제와 2vCPU, 4GB RAM 이상의 스펙을 권장합니다. 호스팅 설정 및 서버 인스턴스 생성 과정은 아래 상세 가이드 페이지를 참고하여 진행해 주시기 바랍니다.
국내 표준 cafe24 가상 서버 준비하기 포스팅
초보자 친화적인 Hostinger VPS 준비하기 포스팅
압도적 가성비의 Contabo VPS 준비하기 포스팅
2단계: VPS SSH 접속 및 시스템 기본 설정
VPS 인스턴스 생성이 완료되었다면, 서버의 터미널에 접속하여 Hermes AI 에이전트를 설치할 환경을 구성해야 합니다. 본 가이드에서는 가장 널리 쓰이는 SSH 접속 방식을 기준으로 설명합니다.
윈도우 사용자라면 PowerShell이나 PuTTY를, 맥(Mac) 사용자라면 기본 Terminal 앱을 열고 아래 명령어를 입력하여 서버에 접속합니다.
ssh root@your_vps_ip_address
접속 후 최초 로그인에 성공했다면 시스템 패키지를 최신 상태로 업데이트하고 에이전트 구동에 필요한 필수 의존성 도구들을 설치해 줍니다.
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential python3 python3-pip python3-venv nodejs npm3단계: Hermes AI 에이전트 다운로드 및 설정
시스템 환경 설정이 끝났다면 본격적으로 Hermes AI 에이전트 소스코드를 클론하고 설치를 진행합니다.
[이미지 설명: Git clone command and code editing inside bash environment]
우선 공식 리포지토리로부터 코드를 내려받고 해당 디렉터리로 이동합니다.
git clone https://github.com/HermesAI/agent.git hermes-agent
cd hermes-agent
이어서 파이썬 가상환경(Virtual Environment)을 생성하고 활성화하여 패키지 간의 충돌을 방지합니다.
python3 -m venv venv
source venv/bin/activate
필요한 파이썬 라이브러리 의존성 파일들을 일괄 설치해 줍니다.
pip install -r requirements.txt
설치가 완료되면 환경 설정 파일(.env)을 복사하고, 텍스트 에디터(nano 등)를 통해 필수 API 키 및 설정 정보들을 입력해 줍니다.
cp .env.example .env
nano .env
설정 파일 내에 사용하는 LLM API(예: OpenAI, Anthropic 등)의 API 키 값을 정확히 입력한 후 저장하고 나옵니다. (Nano 에디터 기준: Ctrl + O 저장, Ctrl + X 종료)
4단계: 텔레그램(Telegram) 연동하기
구축한 Hermes AI 에이전트와 언제 어디서나 대화하고 명령을 내릴 수 있도록 대중적인 메신저인 텔레그램의 봇(Bot) 기능을 연동해 보겠습니다.
1) 텔레그램 봇 생성 및 토큰 발급
1. 스마트폰 또는 PC에서 텔레그램 앱을 켭니다.
2. 검색창에 @BotFather를 검색하여 공식 인증 마크가 있는 계정과의 대화를 시작합니다.
3. 대화방에 /newbot 명령어를 전송합니다.
4. 봇의 이름(Name)과 유저네임(Username, 반드시 bot으로 끝나야 함)을 순서대로 지정해 줍니다.
5. 생성이 완료되면 HTTP API token이 발급됩니다. 이 토큰값은 외부 노출이 되지 않도록 안전하게 보관하세요.
2) 에이전트 설정 파일(.env)에 토큰 등록
다시 VPS SSH 터미널 화면으로 돌아와서 아까 열었던 .env 파일 내의 텔레그램 관련 항목 정보를 업데이트해 줍니다.
TELEGRAM_BOT_TOKEN=your_generated_bot_token_here
ALLOWED_TELEGRAM_USER_IDS=your_personal_telegram_numeric_id
*주의: 무분별한 타인의 접속을 막고 나만 에이전트를 사용하기 위해 본인의 Telegram User ID를 식별하여 ALLOWED_TELEGRAM_USER_IDS에 기입해 두는 것을 강력히 권장합니다. (User ID는 @userinfobot 등을 통해 쉽게 확인할 수 있습니다.)
5단계: 백그라운드 상시 구동 및 테스트
모든 세팅이 끝났다면 SSH 접속을 종료하더라도 AI 에이전트가 꺼지지 않고 서버 내부에서 계속 실행되도록 프로세스 매니저(PM2) 또는 systemd 서비스를 활용해 백그라운드 상시 구동 설정을 적용해야 합니다.
가장 간편한 PM2를 사용해 구동해 보겠습니다. npm을 활용해 PM2를 설치하고 에이전트를 백그라운드에서 구동합니다.
sudo npm install -g pm2
pm2 start app.py --name "hermes-agent" --interpreter venv/bin/python3
pm2 save
pm2 startup
이제 설정한 텔레그램 봇으로 대화를 걸어 정상적으로 답변이 오는지 확인해 보세요. 나만의 전용 Hermes AI 에이전트가 24시간 실시간으로 당신의 질문에 응답하며 지시사항들을 안전하게 처리해 줄 것입니다.