Hermes Hindsight 로컬 임베디드 설치 및 설정 완료

Hermes Hindsight 로컬 임베디드 설치 및 설정 완료

[!note] 수정이력 | 2026-05-06 22:36, 루키 (hermes)

개요

Hermes Agent의 Context Compression으로 인해 대화 중 기억이 희석되는 문제를 해결하기 위해 Hindsight 로컬 임베디드 메모리 프로바이더 도입.

환경

• 장비: 맥미니 M4 Pro
• Ollama: 로컬 실행 중 (localhost:11434)
• 모델: qwen3.6:27b (17.4GB, Q4_K_M)
• Hindsight client: 0.6.0

이슈 참조

• Gitea: #3 - 40- 옵시디언 관리
• 이전 매뉴얼: 20260506_2016_Hermes_Hindsight_로컬_임베디드_설치_매뉴얼.md

설치 과정

1. hindsight-client 설치

uv pip install hindsight-client

• 결과: v0.6.0 설치 완료

2. Hindsight 설정 파일 생성

경로: ~/.hermes/hindsight/config.json

{
  "mode": "local_embedded",
  "llm_provider": "openai_compatible",
  "llm_model": "qwen3.6:27b",
  "llm_base_url": "http://localhost:11434/v1"
}

3. 환경변수 설정

경로: ~/.hermes/.env (하단에 추가)

HINDSIGHT_MODE=local_embedded
HINDSIGHT_LLM_PROVIDER=ollama
HINDSIGHT_LLM_MODEL=qwen3.6:27b

4. Hermes config.yaml 설정 (⚠️ 핵심 누락 설정!)

경로: ~/.hermes/config.yaml

memory:
  provider: hindsight          # ← 이게 없어서 처음에 작동 안 했었음!
  memory_enabled: true
  user_profile_enabled: true

5. hindsight-embed 데몬

• Hermes 다음 실행 시 자동 설치 및 시작 예정
• 데몬 로그: ~/.hermes/logs/hindsight-embed.log
• PostgreSQL 데이터: ~/.hindsight/profiles/hermes/
• 데몬 UI: hindsight-embed -p hermes ui start (자동 설치 후 사용 가능)

주요 파일 경로 요약

• Hermes 전역 설정: ~/.hermes/config.yaml
• Hindsight 전용 설정: ~/.hermes/hindsight/config.json
• 환경변수: ~/.hermes/.env
• 데몬 초기화 로그: ~/.hermes/logs/hindsight-embed.log
• 런타임 로그: ~/.hindsight/profiles/hermes.log

현재 상태

• hindsight-client 설치 (v0.6.0)
• Ollama 로컬 모델 연동 설정
• Hermes config 연동 (provider: hindsight 추가 완료)
• hindsight-embed 데몬 첫 실행 및 PostgreSQL 초기화 (다음 Hermes 실행 시 자동)
• 메모리 저장/검색 실제 테스트 (hindsight_retain/hindsight_recall)
• Context Compression 대비 동작 확인

다음 단계

1. Hermes 재시작 또는 새 세션 시작 → hindsight-embed 데몬 자동 초기화
2. 데몬 로그 확인: tail -f ~/.hermes/logs/hindsight-embed.log
3. 메모리 툴 테스트
   • hindsight_retain으로 테스트 메모리 저장
   • hindsight_recall으로 저장된 메모리 검색
4. 대화를 길게 이어가며 Context Compression 발생 시 메모리 유지 여부 확인