본문으로 건너뛰기

프로필: 다중 에이전트를 실행

같은 기계에 여러 독립적 인 헤르메스 에이전트를 실행 - 자체 구성, API 키, 메모리, 세션, 기술 및 게이트웨이 상태와 각각.

프로필이란?​

프로필은 별도의 Hermes 홈 디렉토리입니다. 각 프로필은 자체 config.yaml, .env, SOUL.md, 메모리, 세션, 기술, Cron 작업 및 상태 데이터베이스를 포함하는 자체 디렉토리를 가져옵니다. 프로필은 다른 목적으로 별도의 에이전트를 실행합니다 - 코딩 조수, 개인 봇, 연구 에이전트 - Hermes 상태를 섞지 않고.

프로필을 만들 때 자동으로 자신의 명령이됩니다. coder라는 프로필을 작성하고 즉시 coder chat, coder setup, coder gateway start 등을 가지고 있습니다.

빠른 시작​

사이트맵

그게 다. coder는 이제 자체 구성, 메모리 및 상태와 자신의 Hermes 프로필입니다.

프로필 만들기​

# 빈 프로파일​

hermes profile create mybot

번들 스킬로 신선한 프로필을 만듭니다. mybot setup를 실행하여 API 키, 모델 및 게이트웨이 토큰을 구성합니다.

Clone 구성 (--clone)​

사이트맵

현재 프로필의 config.yaml, .env 및 SOUL.md를 새로운 프로필에 복사합니다. 동일한 API 키와 모델, 하지만 신선한 세션과 메모리. 다른 API 키에 대한 ~/.hermes/profiles/work/.env 편집, 또는 다른 성격에 대한 ~/.hermes/profiles/work/SOUL.md.

모든 것을 복제 (--clone-all)​

사이트맵

Copieseverything — 구성, API 키, 개성, 모든 기억, 전체 세션 역사, 기술, cron 작업, 플러그인. 완전한 스냅샷. 백업 또는 이미 상황에 맞는 에이전트를 찾는 데 유용합니다.

특정 프로필에서 혼자​

hermes profile create work --clone --clone-from coder
가격 Honcho 메모리 + 프로필

Honcho가 활성화되면 --clone는 동일한 사용자 작업 공간을 공유하면서 새로운 프로필에 전용 AI 피어를 자동으로 생성합니다. 각 프로필은 자신의 관찰과 정체성을 구축합니다. Honcho -- 멀티 시약 / 프로필 세부 사항. 주요 특징

프로파일 사용​

명령 별명​

모든 프로필은 ~/.local/bin/<name>에서 명령 별명을 자동으로 가져옵니다.

coder chat                    # chat with the coder agent
coder setup                   # configure coder's settings
coder gateway start           # start coder's gateway
coder doctor                  # check coder's health
coder skills list             # list coder's skills
coder config set model.default anthropic/claude-sonnet-4

alias는 모든 hermes subcommand와 함께 작동합니다. 그것은 단지 hermes -p <name> 후드 아래에 있습니다.

-p 플래그​

당신은 또한 어떤 명령으로 명시적으로 프로파일을 대상 할 수 있습니다:

사이트맵

Sticky 기본 (hermes profile use)​

사이트맵

일반 hermes 명령을 사용하여 프로파일을 타겟으로 설정합니다. kubectl config use-컨텍스트와 같은.

당신이 어디에 있는지 알고​

CLI는 항상 프로파일이 활성화된 것을 보여줍니다:

-Prompt: coder ❯ 대신 ❯ -Banner: Profile: coder를 시작합니다.

  • ** hermes profile**: 현재 프로필 이름, 경로, 모델, 게이트웨이 상태 표시

프로필 대 workspaces 대 sandboxing​

프로필은 종종 작업 공간 또는 샌드 박스와 혼동되지만 다른 것들입니다.

  • Aprofile는 자신의 주 디렉토리를 제공합니다: config.yaml, .env, SOUL.md, 세션, 메모리, 로그, 크론 작업 및 게이트웨이 상태.
  • A workspace또는working directory는 터미널 명령이 시작되는 곳이다. 그것은 terminal.cwd에 의해 따로따로 통제됩니다.
  • A sandbox는 어떤 제한 파일 시스템 액세스입니다. Profiles do ** 샌드박스 에이전트.

기본 local 터미널 백엔드에서, 에이전트는 여전히 사용자 계정과 동일한 파일 시스템 액세스를 가지고 있습니다. 프로파일은 프로파일 디렉토리 밖에서 폴더에 접근하지 않습니다.

특정 프로젝트 폴더에서 시작하려면 프로파일을 원하면 프로파일의 terminal.cwd를 명시적으로 설정하세요.

terminal:
  backend: local
  cwd: /absolute/path/to/project

로컬 백엔드의 cwd: "."를 사용하여 "디폴트 Hermes가 시작되었습니다"라고 "프로필 디렉토리"가 아닙니다.

참고 사항:

  • SOUL.md는 모델을 안내 할 수 있지만 작업 공간 경계를 시행하지 않습니다.
  • SOUL.md로 변경하면 새로운 세션에서 효과를 낼 수 있습니다. 기존 세션은 여전히 오래된 프롬프트 상태를 사용할 수 있습니다.
  • "what directory are you in?" 는 신뢰할 수있는 고립 테스트가 아닙니다. 도구에 대한 예측 가능한 시작 디렉토리가 필요하면 terminal.cwd를 명시적으로 설정합니다.

실행 게이트웨이​

각 프로파일은 자체 봇 토큰을 사용하여 별도의 프로세스로 자체 게이트웨이를 실행합니다.

모델 번호: ```bash coder gateway start # starts coder's gateway assistant gateway start # starts assistant's gateway (separate process)


### 다른 봇 토큰

각 프로필에는 자체 `.env` 파일이 있습니다. 서로 다른 Telegram/Discord/Slack bot 토큰 구성:

```bash
# Edit coder's tokens
nano ~/.hermes/profiles/coder/.env

# Edit assistant's tokens
nano ~/.hermes/profiles/assistant/.env

안전: 토큰 자물쇠​

두 개의 프로파일이 실수로 동일한 봇 토큰을 사용한다면, 두 번째 게이트웨이는 충돌 프로파일을 명명하는 명확한 오류로 차단됩니다. Telegram, Discord, Slack, WhatsApp 및 신호에 대한 지원.

영구 서비스​

coder gateway install         # creates hermes-gateway-coder systemd/launchd service
assistant gateway install     # creates hermes-gateway-assistant service

각 프로필은 자신의 서비스 이름을 가져옵니다. 그들은 독립적으로 실행.

프로필 구성​

각 단면도에는 그것의 소유가 있습니다:

  • config.yaml - 모델, 공급자, 도구, 모든 설정
  • .env - API 키, 봇 토큰
  • SOUL.md - 성격 및 지침
coder config set model.default anthropic/claude-sonnet-4
echo "You are a focused coding assistant." > ~/.hermes/profiles/coder/SOUL.md

이 프로파일을 기본으로 특정 프로젝트에서 작업하려면 자체 terminal.cwd를 설정하십시오.

coder config set terminal.cwd /absolute/path/to/project

업데이트​

hermes update는 코드를 한 번 끌어 (공유) 그리고 ** 모든** 프로파일에 새로운 번들 기술 동기화:

hermes update
# → Code updated (12 commits)
# → Skills synced: default (up to date), coder (+2 new), assistant (+2 new)

사용자 정의 기술은 결코 과잉하지 않습니다.

프로필 관리​

hermes profile list           # show all profiles with status
hermes profile show coder     # detailed info for one profile
hermes profile rename coder dev-bot   # rename (updates alias + service)
hermes profile export coder   # export to coder.tar.gz
hermes profile import coder.tar.gz   # import from archive

프로필 삭제​

hermes profile delete coder

이 게이트웨이를 중지하고 systemd/launchd 서비스를 제거하고 명령 별명을 제거하고 모든 프로필 데이터를 삭제합니다. 확인하려면 프로필 이름을 입력해야합니다.

--yes를 사용하여 확인을 건너뛰기: hermes profile delete coder --yes

기사

기본 프로파일을 삭제할 수 없습니다 (~/.hermes). 모든 것을 제거하려면 hermes uninstall를 사용하십시오. 주요 특징

탭 완료​

# Bash
eval "$(hermes completion bash)"

# Zsh
eval "$(hermes completion zsh)"

지속적인 완료를 위해 ~/.bashrc 또는 ~/.zshrc에 선을 추가하십시오. -p, 프로파일 서브컴맨드 및 최고 수준의 명령 후 프로파일 이름을 완료합니다.

어떻게 작동합니까?​

프로필은 HERMES_HOME 환경 변수를 사용합니다. coder chat를 실행할 때, 래퍼 스크립트 설정 HERMES_HOME=~/.hermes/profiles/coder를 실행하기 전에. Codebase의 119+ 파일이 get_hermes_home()를 통해 경로를 해결하기 때문에, Hermes는 프로파일의 디렉토리에 자동으로 범위를 설정, 세션, 메모리, 기술, 상태 데이터베이스, 게이트웨이 PID, 로그 및 크론 작업.

이것은 터미널 작업 디렉토리에서 분리됩니다. 도구 실행에서 시작 terminal.cwd (또는 로컬 백엔드에서 cwd: "."가 실행 디렉토리), 자동으로 HERMES_HOME에서.

기본 프로파일은 단순히 ~/.hermes 자체입니다. 마이그레이션 필요 없음 — 기존 설치는 동일하게 작동합니다.

배포로 프로필 공유​

한 기계에 내장 된 프로필은 ** git 저장소로 패키지 할 수 있으며 다른 기계에서 하나의 명령으로 설치 - 자신의 워크 스테이션, 팀메이트의 노트북, 또는 커뮤니티 사용자의 환경. 공유 패키지에는 SOUL, config, Skill, cron jobs 및 MCP 연결을 포함합니다. Credentials, 기억, 그리고 회의는 기계 당 체재합니다.

# Install a whole agent from a git repo
hermes profile install github.com/you/research-bot --alias

# Update later when the author ships a new version (keeps your memories +.env)
hermes profile update research-bot

참조 프로필 배포: 전체 에이전트를 공유 전체 가이드 - 저자, 출판, 업데이트 semantics, 보안 모델 및 사용 사례.