Hermes Agent Tools Recommendations

Hermes Agent 활용 도구·스크립트·라이브러리 추천서

VPS · Telegram · Python 자동화 · GS-PMX · PDF/RAG 업무 기준

작성 기준: 현장 업무 자동화와 헤르메스 에이전트 운영에 바로 적용 가능한 용어와 도구 중심

핵심 요약
Hermes = 지휘관
Python = 실제 작업자
Selenium / Playwright = 브라우저 조종사
Telegram = 현장 접수창구
SQLite = 기록장
systemd = 24시간 당직자

1. 전체 개요

항목	내용
목표	헤르메스 에이전트를 단순 챗봇이 아니라 VPS 위에서 돌아가는 현장 업무 자동화 지휘관으로 활용한다.
핵심 구조	Telegram → Hermes Gateway → AI 모델 → Python/Selenium/Playwright → 업무사이트/파일/사진/PDF 처리
추천 전략	처음부터 플러그인으로 가지 말고 Python 스크립트로 안정화한 뒤, 반복 업무를 Skills/Plugins로 묶는다.
가장 현실적인 1차 조합	Hermes Agent + Telegram Bot + Python Scripts + Selenium/Playwright + watchdog + loguru + SQLite + systemd

2. 추천 운영 구조

사용자
↓
Telegram / Terminal
↓
Hermes Gateway / Hermes CLI
↓
AI 모델
├─ 로컬 Ollama Gemma
├─ OpenRouter Claude / Gemini / DeepSeek
└─ OpenAI / Codex 계열
↓
실행 도구
├─ Python Scripts
├─ Selenium / Playwright
├─ PDF / OCR / RAG
├─ SQLite / PostgreSQL
└─ systemd / 로그 / 백업

3. Hermes 자체 핵심 용어

용어	설명
Hermes Agent	AI 에이전트 본체. 대화, 도구 실행, 작업 흐름을 담당.
Hermes CLI	터미널에서 직접 사용하는 헤르메스 실행 방식.
Hermes Gateway	Telegram, Discord, Slack 같은 외부 채널과 연결하는 방식.
Hermes Skills	반복 작업에 필요한 지식과 절차를 저장하는 설명서 개념.
Hermes Plugins	커스텀 도구, 외부 연동, 훅을 붙이는 확장 구조.
Hermes Sessions	대화와 작업 맥락 단위.
Model Routing	작업 난이도에 따라 로컬 모델과 클라우드 모델을 전환하는 운용 방식.
Fallback Model	주 모델 실패 시 대체 모델로 자동 전환하는 설정.
Backup / Import	헤르메스 상태와 데이터를 백업하고 복원하는 기능.

4. 자주 쓰는 Hermes 명령어

hermes
hermes setup
hermes setup gateway
hermes model
hermes backup
hermes import
hermes update

/new
/model
/status
/queue
/bg
/steer

5. 만들어두면 좋은 Hermes Skills

분야	추천 Skill 이름
GS-PMX 업무보고	gs-pmx-login-skill, gs-pmx-report-writing-skill, gs-pmx-photo-upload-skill
현장 사진 분류	inspection-photo-sort-skill, slab-wall-photo-rule-skill, apartment-unit-folder-rule-skill
TBM 자동화	tbm-report-skill, morning-afternoon-tbm-rule-skill
개발 보조	python-debugging-skill, selenium-debugging-skill, playwright-debugging-skill
서버 운영	vps-troubleshooting-skill, systemd-service-skill, backup-restore-skill
문서/PDF	pdf-rag-skill, construction-drawing-search-skill, ocr-drawing-index-skill
YouTube/Korea Data Lab	korea-topic-research-skill, youtube-script-writing-skill, youtube-fact-check-skill

6. 나중에 만들면 좋은 Hermes Plugins

telegram_message_reader_plugin: 텔레그램 메시지 수신 및 파싱
telegram_photo_downloader_plugin: 텔레그램 사진 자동 저장
gs_pmx_auto_report_plugin: GS-PMX 업무보고 자동화
pmx_photo_upload_plugin: 사진 업로드 자동화
daily_tbm_report_plugin: 아침/점심 TBM 보고 자동화
folder_auto_sort_plugin: 현장 사진 폴더 자동 분류
pdf_drawing_search_plugin: PDF 도면 검색
vps_health_check_plugin: VPS 상태 점검
backup_to_pc_plugin: VPS → PC 백업
ollama_model_status_plugin: 로컬 모델 상태 확인
openrouter_model_switch_plugin: OpenRouter 모델 전환 지원

7. Python 자동화 필수 라이브러리

라이브러리	용도	추천도
requests	HTTP 요청, API 호출	상
python-dotenv	.env 환경변수와 토큰 관리	상
pydantic / pydantic-settings	설정값 검증과 타입 관리	상
typer	CLI 명령어 만들기	중상
rich	터미널 출력 예쁘게 표시	중
schedule	간단한 반복 실행	중
APScheduler	정교한 예약 실행	상
watchdog	폴더 감시 후 자동 처리	상
loguru	로그 관리와 오류 추적	상

pip install requests python-dotenv pydantic pydantic-settings typer rich schedule apscheduler watchdog loguru

8. 웹 자동화: Selenium / Playwright

도구	장점	추천 용도
Selenium	기존 코드와 자료가 많고 브라우저 제어가 익숙함	현재 GS-PMX 자동화 코드 유지/개선
Playwright	대기 처리, 파일 업로드, 브라우저 컨텍스트 관리가 안정적	새 자동화 프로젝트 또는 Selenium 불안정 시 대체
requests + BeautifulSoup	빠르고 가벼움	로그인/클릭이 필요 없는 단순 페이지 수집

pip install selenium webdriver-manager

pip install playwright
playwright install

9. 웹 자동화 필수 용어

WebDriverWait, Expected Conditions, element_to_be_clickable
CSS Selector, XPath, DOM Selector
iframe, Shadow DOM, Session Cookie, Local Storage
input[type="file"], send_keys, click, execute_script
TimeoutException, NoSuchElementException, StaleElementReferenceException
headless browser, headed browser, storage_state

10. Telegram Bot 라이브러리

라이브러리	특징	추천 순위
python-telegram-bot	일반적인 텔레그램 봇 개발에 가장 무난함	1순위
aiogram	비동기 기반 고급 봇 개발에 적합	2순위
telethon	MTProto 기반 고급 기능. 일반 봇보다 복잡함	3순위

pip install python-telegram-bot
pip install aiogram
pip install telethon

11. 이미지/사진 처리 라이브러리

라이브러리	용도
Pillow	이미지 열기, 리사이즈, 압축, 포맷 변환
OpenCV	이미지 분석, 비교, 전처리
imagehash	중복 사진 탐지
piexif / exifread	촬영일시, 기기정보 등 EXIF 읽기/수정

pip install pillow opencv-python imagehash piexif exifread

12. OCR / PDF / RAG 도면 검색

분야	추천 도구	설명
PDF 처리	PyMuPDF, pypdf, pdfplumber, pdf2image	PDF 분리, 병합, 텍스트 추출, 이미지 변환
OCR	pytesseract, EasyOCR, PaddleOCR	이미지 PDF나 스캔 도면에서 문자 추출
RAG	LlamaIndex, LangChain, LangGraph	문서 검색과 AI 질의응답 구조 구성
벡터 DB	ChromaDB, FAISS	임베딩 검색 저장소
임베딩	sentence-transformers	문장/문서 벡터화

pip install pymupdf pypdf pdfplumber pdf2image
pip install pytesseract easyocr paddleocr
pip install langchain langgraph llama-index chromadb faiss-cpu sentence-transformers

이미지 PDF 도면 검색 흐름
PDF 페이지 이미지 변환
↓
OCR로 텍스트 추출
↓
페이지 번호와 함께 인덱싱
↓
ChromaDB / FAISS 저장
↓
검색어 입력
↓
관련 페이지와 도면 위치 반환

13. 로컬 LLM / 모델 실행 / 모델 라우팅

도구	용도
Ollama	로컬 모델 실행. Gemma, Llama 등 사용
Open WebUI	로컬 LLM 웹 UI
LM Studio	로컬 모델 테스트와 채팅 UI
LiteLLM	여러 모델을 OpenAI API 형식으로 통합
OpenRouter	Claude, Gemini, DeepSeek 등 여러 클라우드 모델 접속
vLLM / llama.cpp	고성능 로컬 추론 또는 서버형 모델 실행

ollama list
ollama run gemma4:latest
ollama run gemma4:31b
ollama rm 모델명

pip install litellm

14. VPS 운영 필수 도구

도구	용도
htop / btop	CPU, 메모리, 프로세스 상태 확인
tmux / screen	터미널 세션 유지
curl / wget	API 테스트와 파일 다운로드
jq	JSON 보기와 가공
rsync / scp	파일 백업과 서버 간 복사
ufw	리눅스 방화벽
fail2ban	SSH 무차별 로그인 방어
journalctl	systemd 서비스 로그 확인

sudo apt update
sudo apt install -y htop btop tmux screen curl wget jq unzip rsync ufw fail2ban

15. 상시 실행과 서비스 관리

systemd: 리눅스 서버에서 가장 정석적인 서비스 관리 방식
systemctl: 서비스 시작, 중지, 재시작, 상태 확인
journalctl: 서비스 로그 확인
PM2: Node.js 앱이나 간단한 프로세스 관리에 유용
Supervisor: 파이썬 데몬을 단순하게 관리할 때 사용 가능

sudo systemctl status 서비스명
sudo systemctl restart 서비스명
sudo journalctl -u 서비스명 -f

16. 백업/동기화/보안

분야	도구	설명
백업	rsync, rclone, restic, borgbackup	PC, 외장 SSD, 클라우드로 백업
보안	ufw, fail2ban, ssh key login	서버 접근 보호
비밀키 관리	.env, Bitwarden CLI, 1Password CLI, sops	API 키와 토큰 분리 관리
접속	Tailscale, Cloudflare Tunnel	안전한 원격 접속 또는 공개 터널

17. Windows / Excel / 로컬 프린터 자동화

도구	용도
pyautogui	마우스/키보드 자동화
pywinauto	Windows 앱 제어
pywin32	프린터, Windows API, Office 제어
PowerShell	Windows 관리 자동화
Windows Task Scheduler	예약 실행
AutoHotkey	반복 입력과 단축키 자동화
openpyxl	xlsx 파일 읽기/쓰기
pandas	표 데이터 처리
xlwings	실제 Excel 프로그램 제어

pip install pyautogui pywinauto pywin32 keyboard mouse
pip install openpyxl pandas xlsxwriter xlwings

18. 데이터베이스와 홈페이지 제작

도구	추천 용도
SQLite	개인 자동화, 현장 사진/보고 이력 저장
PostgreSQL	홈페이지와 여러 사용자 데이터 저장
Redis	작업 큐, 임시 상태, 캐시
FastAPI	현장 홈페이지/API 서버
Flask	작고 단순한 웹앱
Django	관리자 페이지가 필요한 큰 서비스
Nginx / Caddy	웹서버와 HTTPS 프록시

pip install fastapi uvicorn flask django sqlalchemy psycopg2-binary redis

19. Docker / 모니터링 / 작업 큐

분야	도구	설명
Docker	Docker, Docker Compose, Portainer, Watchtower	앱과 DB를 컨테이너로 격리 실행
모니터링	Uptime Kuma, Netdata, Glances, Grafana, Prometheus	서버와 서비스 상태 확인
오류 추적	Sentry, loguru	파이썬 오류와 로그 관리
작업 큐	Celery, RQ, Dramatiq, Redis	OCR/PDF/사진 처리 같은 오래 걸리는 작업 대기열

pip install celery rq dramatiq redis
sudo apt install glances

20. 코드 품질 / 테스트 / Git

도구	용도
black	파이썬 코드 자동 정리. 들여쓰기 문제 예방
ruff	문법/스타일 오류 빠른 검사
pytest	자동 테스트
mypy	타입 검사
pre-commit	커밋 전 자동 검사
git	버전 관리와 이전 코드 복구
GitHub CLI / lazygit	Git 작업 편의 도구

pip install black ruff pytest mypy pre-commit

black gs_pmx_login3.py
ruff check gs_pmx_login3.py
pytest

21. AI 코딩 에이전트 / 개발 보조 도구

도구	특징
Codex	코드 작성/수정 중심 AI 작업 보조
Claude Code	터미널 기반 코드 작업에 강함
Aider	Git 기반 코드 수정 에이전트
Continue	VS Code 안에서 로컬/클라우드 모델 연결
Cline / Roo Code	VS Code 기반 에이전트형 코딩 도구
OpenHands	브라우저/터미널 작업형 오픈소스 에이전트
Cursor	AI 중심 코드 에디터

22. 현장 자동화 프로젝트 이름과 폴더 구조

pmx-bot: GS-PMX 자동 보고 봇
tbm-bot: TBM 보고 자동화
inspec-sorter: 검측 사진 자동 분류
site-photo-hub: 현장 사진 수집/관리 홈페이지
drawing-rag: 도면 PDF 검색 시스템
field-report-agent: 현장 업무보고 AI 에이전트

pmx_auto/
config/
logs/
photos/
reports/
scripts/
skills/
tests/
backups/

23. 우선 설치 세트

단계	설치 명령	목적
1단계	pip install python-dotenv pydantic loguru rich typer watchdog	기본 자동화
2단계	pip install selenium webdriver-manager	기존 웹 자동화
3단계	pip install playwright && playwright install	새 브라우저 자동화
4단계	pip install python-telegram-bot	텔레그램 봇
5단계	pip install pillow opencv-python pymupdf pypdf pdf2image	사진/PDF 처리
6단계	pip install black ruff pytest	코드 정리/테스트

24. 최우선 추천 TOP 30

추천 1	추천 2	추천 3
1. Hermes Skills	2. Hermes Plugins	3. Hermes Gateway
4. python-telegram-bot	5. Selenium	6. Playwright
7. WebDriverWait	8. CSS Selector	9. XPath
10. watchdog	11. loguru	12. python-dotenv
13. pydantic	14. Typer	15. Rich
16. PyMuPDF	17. Pillow	18. OpenCV
19. ChromaDB	20. LlamaIndex	21. LangGraph
22. SQLite	23. FastAPI	24. Uvicorn
25. Nginx	26. systemd	27. journalctl
28. rsync	29. rclone	30. Uptime Kuma

25. 헤르메스에 시키기 좋은 명령 예시

코드 분석

이 폴더의 gs_pmx_login3.py를 분석하고, 로그인/작성구분/시간선택/사진업로드 부분을 함수별로 설명해줘. 아직 수정하지 말고 문제점만 정리해줘.

코드 수정

gs_pmx_login3.py에서 오전/오후 선택과 시간 선택 부분만 수정해줘. 기존 로그인과 사진업로드 코드는 건드리지 마.

스킬 생성

방금 수정한 GS-PMX 시간 선택 방식과 주의사항을 Hermes skill로 저장해줘. 다음에 비슷한 오류가 나면 이 방식을 먼저 참고하게 해줘.

텔레그램 자동화

텔레그램으로 받은 메시지에서 작업인원, 동, 층, 작업내용을 파싱하는 파이썬 함수를 만들어줘.

VPS 점검

현재 VPS에서 Hermes Gateway가 정상 실행 중인지 확인하고, 죽어 있으면 재시작하는 점검 스크립트를 만들어줘.

26. 추천 진행 순서

현재 사용 중인 Python 자동화 코드를 Git으로 관리한다.
GS-PMX 자동화 코드를 Selenium 기준으로 안정화한다.
텔레그램 메시지/사진 수신 스크립트를 만든다.
작업내용 파싱, 사진 저장, 폴더 분류를 Python으로 먼저 완성한다.
VPS에서 systemd로 상시 실행한다.
로그와 실패 알림을 Telegram으로 받는다.
반복되는 절차를 Hermes Skills로 저장한다.
충분히 안정화된 기능만 Hermes Plugin으로 확장한다.
PDF 도면 검색은 PyMuPDF + OCR + ChromaDB 구조로 별도 구축한다.
최종적으로 현장 사진/보고/도면 검색을 하나의 홈페이지 또는 Telegram 인터페이스로 묶는다.

27. 참고 공식 자료

Hermes Agent GitHub 및 공식 문서: Hermes Agent, Skills, Plugins, Gateway 개념 확인용
Playwright Python 공식 문서: 브라우저 자동화와 테스트 자동화 확인용
LangGraph 공식 문서: 에이전트 워크플로우와 상태 기반 자동화 확인용