Hermes Agent 딥다이브
— 경험에서 스킬을 학습하고 스스로 성장하는 자기개선형 AI 에이전트

┌─────────────────────────────────────────────────────────────────┐ │ 사용자 인터페이스 │ │ CLI(TUI) │ Telegram │ Slack │ Discord │ WhatsApp │ Signal │ └───────────────────────────┬─────────────────────────────────────┘ ▼ ┌───────────────────────┐ │ Gateway (통합 라우터) │ │ channel_dir / pairing │ │ delivery / session │ └──────────┬────────────┘ ▼ ┌──────────────────────────────────────────────────────────────────┐ │ AIAgent (run_agent.py) — 핵심 오케스트레이터 │ │ ~5,462 lines │ │ Prompt Builder │ Context Compressor │ Smart Router │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ LLM API Layer (멀티 프로바이더) │ │ │ │ OpenAI │ Anthropic │ OpenRouter │ Nous │ Kimi │ MiniMax │ │ │ └──────────────────────────────────────────────────────────┘ │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ Tool Execution Engine │ │ │ │ 터미널/코드실행 │ 웹/브라우저 │ 파일작업 │ MCP │ 이미지 │ │ │ └──────────────────────────────────────────────────────────┘ │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ Persistence Layer │ │ │ │ MEMORY.md │ USER.md │ Skills (SKILL.md) │ SQLite FTS5 │ │ │ └──────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────┘ ▼ ┌──────────────────────────────────────────────────────────────────┐ │ Terminal Backends (6종) │ │ Local │ Docker │ SSH │ Daytona │ Singularity │ Modal │ └──────────────────────────────────────────────────────────────────┘

작업 수행 → 복잡한 패턴 감지 → 스킬 자동 생성(SKILL.md) ↑ │ │ 재사용 시 스킬 개선 │ └─────────────────────────────────────┘ 1. 복잡한 작업 완료 → skill_manager_tool.py가 SKILL.md 생성 2. 보안 스캐닝 후 ~/.hermes/skills/ 에 저장 3. 다음 세션 유사 작업 → 스킬 인덱스 참조 4. 스킬이 불완전하면 patch 작업으로 점진적 개선

class MemoryStore:
    _system_prompt_snapshot  # 세션 시작 시 고정 (프리픽스 캐시 보존)
    memory_entries           # 실시간 업데이트 (디스크 즉시 반영)
    user_entries             # 사용자 프로필 (별도 관리)

사용자 메시지 → 라우팅 판단 │ ├─ 160자 이하 + 28단어 이하 + 코드블록 없음 │ + URL 없음 + 복잡 키워드 없음 │ → 저렴한 모델로 라우팅 (비용/지연 절감) │ └─ 그 외 → 프라이머리 모델 유지 31개 복잡도 키워드: debug, implement, refactor, analyze, design, docker, test, architecture, optimize ...

1. .hermes.md / HERMES.md (git root까지 탐색) 2. AGENTS.md (재귀 디렉토리 스캔) 3. CLAUDE.md (작업 디렉토리만) 4. .cursorrules (작업 디렉토리만) 보안: _scan_context_content()로 프롬프트 인젝션 패턴, 투명 유니코드(U+200B 등) 차단

hermes-agent/ ├── agent/ # 핵심 에이전트 엔진 (90개 이상 모듈) │ ├── prompt_builder.py # 시스템 프롬프트 조립 │ ├── context_compressor.py # 5단계 컨텍스트 압축 │ ├── model_metadata.py # 모델 라우팅: _should_use_cheap_model() 내장 │ ├── anthropic_adapter.py # Anthropic API 어댑터 │ ├── prompt_caching.py # 프리픽스 캐싱 최적화 │ ├── trajectory.py # 대화 트래젝토리 관리 (RL용) │ └── usage_pricing.py # API 비용 추적 │ ├── tools/ # 40개 이상 도구 모듈 │ ├── terminal_tool.py # 셸 명령 실행 │ ├── memory_tool.py # MEMORY.md / USER.md 관리 │ ├── skill_manager_tool.py # 스킬 생성/편집/패치/삭제 │ ├── skills_guard.py # 스킬 보안 검증 │ ├── skills_hub.py # agentskills.io 통합 │ ├── delegate_tool.py # 서브에이전트 생성 │ ├── mcp_tool.py # MCP 서버 연동 │ ├── mixture_of_agents_tool.py # MoA (다중 에이전트 합의) │ └── session_search_tool.py # FTS5 세션 검색 │ ├── skills/ # 18개 카테고리 내장 스킬 │ ├── software-development/ │ ├── research/ │ ├── data-science/ │ └── smart-home/ ... │ ├── gateway/ # 멀티플랫폼 메시징 게이트웨이 │ ├── platforms/ # 플랫폼별 어댑터 │ └── hooks.py # 이벤트 훅 │ ├── run_agent.py # AIAgent 클래스 (5,462줄, 핵심) ├── toolsets.py # 도구셋 정의 (~50개 코어 도구) └── batch_runner.py # 배치 트래젝토리 생성 (RL용)

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes model   # LLM 프로바이더 설정
hermes         # 대화 시작

나는 한국어를 주 언어로 사용하는 개발 어시스턴트입니다.
코드 리뷰 시 항상 보안 관점을 포함합니다.
답변은 간결하게, 코드 예시와 함께 제공합니다.

hermes gateway setup   # Telegram Bot 토큰 입력
hermes gateway start   # 게이트웨이 시작