From eced4543d234a2854f920a09c4edfb20768614e0 Mon Sep 17 00:00:00 2001 From: 21in7 Date: Thu, 18 Jun 2026 23:52:39 +0900 Subject: [PATCH] docs: document Hermes Agent deploy flow MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds hermes.tf / hermes-variables.tf / scripts/hermes-bootstrap.sh rows to the structure table, and appends a Hermes Agent section with the 4-step deploy sequence (host prep → terraform apply → pct set bind mounts → in-container bootstrap). Notes that mp0/mp1 are outside TF state and need a future terraform import. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index 2739cff..ff2b2f6 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,9 @@ Terraform으로 관리하는 Proxmox 홈랩 인프라. | `variables.tf` | 공통 변수 | | `pbs.tf` | PBS LXC 컨테이너 정의 | | `pbs-variables.tf` | PBS 관련 변수 | +| `hermes.tf` | Hermes Agent LXC 컨테이너 정의 (token-safe skeleton) | +| `hermes-variables.tf` | Hermes 관련 변수 | +| `scripts/hermes-bootstrap.sh` | Hermes 인-컨테이너 설치 스크립트 | | `outputs.tf` | 출력값 | ## 사용법 @@ -40,3 +43,16 @@ terraform apply - gihyeon: `10.1.10.0/24` - gihyeon2: `10.1.20.0/24` + +## Hermes Agent (LXC #118) + +litellm(#117, `10.1.10.22:4000`)을 LLM 게이트웨이로 쓰는 Nous Research Hermes Agent. +배포는 4단계 (bind mount·features는 API 토큰 불가 → 콘솔 `pct set`): + +1. 호스트 준비(node1 콘솔): `mkdir -p /mnt/pve/hdd/hermes /media/2tb/hermes && chown 100000:100000 /mnt/pve/hdd/hermes /media/2tb/hermes` +2. `terraform apply` (컨테이너 생성) +3. node1 콘솔: `pct set 118 -features nesting=1,keyctl=1 -mp0 /mnt/pve/hdd/hermes,mp=/data -mp1 /media/2tb/hermes,mp=/fast && pct reboot 118` +4. LXC 콘솔: `scripts/hermes-bootstrap.sh` 실행 → `/opt/hermes-stack/.env` 채우고 `docker compose run --rm hermes setup` → `docker compose up -d` + +> 비밀값(litellm 키·봇 토큰)은 컨테이너의 `/opt/hermes-stack/.env`에만 두고 repo에 커밋하지 않는다. +> TODO: hermes `mp0/mp1`는 TF state에 없음 → 추후 `terraform import`로 따라잡기.