코딩 도구
Hermes Agent
Hermes Agent를 TokenLab에 연결하기
기존 계정 및 도구 권한을 유지하면서 Hermes에서 TokenLab을 명명된 모델 공급자(named model provider)로 사용하세요.
에이전트를 통한 설정
컴퓨터에서 실행 중인 에이전트에 다음 작업을 복사하세요:
Read this guide and help me connect Hermes to TokenLab:
https://tokenlab.sh/docs/ko/integrations/hermes-agent
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Hermes 설치 또는 확인
공식 설치 가이드를 따르세요. Apple Silicon macOS 및 Windows용 데스크톱 설치 프로그램과 Linux 및 기본 Windows용 CLI 경로를 제공합니다. 시스템 요구 사항을 확인하고, Hermes가 이미 설치되어 있다면 설치 단계를 건너뛰세요.
선택 사항: 되돌릴 수 있는 설정
공식 Hermes 0.21.3 버전의 경우 TokenLab Skills 0.1.3에 포함된 Hermes 헬퍼를 사용하세요. 이 도구는 변경 사항을 미리 보고 백업하며, 명명된 공급자만 추가하고 YAML 주석, 계정, 기본 모델 및 권한을 유지합니다. 먼저 설정 참조를 읽어보세요.
SKILL_DIR을 설치된 tokenlab-api-integration 폴더로, HERMES_PYTHON을 hermes --version으로 확인되는 Hermes 설치 경로의 Python(macOS/Linux의 경우 venv/bin/python, Windows의 경우 venv\Scripts\python.exe)으로 설정하세요. PowerShell은 $SkillDir 및 $HermesPython을 사용합니다. 기존 환경을 사용하세요. 헬퍼는 전역 Python 패키지를 설치하지 않습니다.
"$HERMES_PYTHON" "$SKILL_DIR/scripts/configure_hermes.py" --model gpt-5.6-luna
"$HERMES_PYTHON" "$SKILL_DIR/scripts/configure_hermes.py" --model gpt-5.6-luna --apply& $HermesPython "$SkillDir/scripts/configure_hermes.py" --model gpt-5.6-luna
& $HermesPython "$SkillDir/scripts/configure_hermes.py" --model gpt-5.6-luna --apply적용 후 아래의 수동 병합 단계는 건너뛰세요. 헬퍼가 출력하는 홈 및 로딩 명령을 따르세요. 헬퍼가 active_profile을 감지합니다. 구성 검사는 키를 유효성 검사하지 않습니다. --restore로 복원을 미리 보고, --apply를 추가하여 원래 바이트로 복원하세요. 충돌, 이후 편집, 관리형 설정 및 WSL은 자동 설정을 중단시킵니다. 해당 설정을 유지하고 수동 경로를 사용하세요.
명명된 공급자 구성
활성 Hermes 디렉토리를 찾으세요: 설정된 경우 HERMES_HOME, 그렇지 않으면 ~/.hermes (Windows: %LOCALAPPDATA%\hermes)입니다. config.yaml을 백업한 다음, 다른 설정을 대체하지 말고 다음 항목을 병합하세요. 예제는 Chat Completions를 사용합니다. 이 형식과 도구 호출을 지원하는 최신 모델을 선택하세요.
활성 구성을 백업하세요. TokenLab 항목만 추가하고 기존 공급자, 계정, 기본 모델 선택 및 권한을 유지하세요. 이름이 이미 사용 중인 경우 다른 이름을 선택하고 명령을 업데이트하세요. 설정을 취소하려면 추가한 항목만 제거하거나 이전 백업본으로 복원하세요.
providers:
tokenlab:
api: https://api.tokenlab.sh/v1
key_env: TOKENLAB_API_KEY
transport: chat_completions
default_model: gpt-5.6-lunaAPI keys에서 키를 생성하세요. Hermes 디렉토리의 .env 파일이나 Hermes를 시작하는 프로세스의 환경 변수에 TOKENLAB_API_KEY로 로컬에 입력하세요. 대화창에 키를 붙여넣거나 공급자 YAML 파일에 직접 넣지 마세요.
구성 확인 및 요청 실행
hermes config get providers.tokenlab.api로 추가된 공급자를 확인하세요. https://api.tokenlab.sh/v1이 표시되어야 합니다. 기존 model 섹션은 변경하지 마세요. 아래의 명시적 공급자 및 모델을 사용하여 새 세션을 시작하세요. 이전 기본값을 사용하려면 이러한 플래그 없이 평소처럼 실행하세요. 구성 검사는 키를 유효성 검사하지 않습니다.
hermes chat --provider custom:tokenlab --model gpt-5.6-lunaTokenLab 잔액을 사용할 준비가 되면 짧은 텍스트 요청을 보내세요. 응답과 Requests의 일치하는 기록을 확인하세요. 그 후에 읽기 전용 도구 작업을 시도하세요. 보조 모델과 선택적 도구는 별도의 공급자나 키를 가질 수 있습니다.
복원 및 문제 해결
공급자를 알 수 없는 경우, 설치된 버전과 현재 공급자 형식을 확인하세요. 인증 오류가 발생하면 키를 출력하지 말고 로컬 환경과 키 상태를 확인하세요. 설정을 취소하려면 이전 모델 선택으로 복원하고 추가한 TokenLab 항목만 제거하세요.
동일한 에이전트에서 이미지 및 비디오 생성
Hermes는 TokenLab MCP server를 사용하여 이미지와 짧은 비디오를 생성할 수도 있습니다. 각 생성 비용은 동일한 TokenLab 잔액에서 차감됩니다. 다음 항목을 동일한 config.yaml에 병합하세요:
mcp_servers:
tokenlab:
command: "npx"
args: ["-y", "@tokenlabai/mcp-server@0.6.48"]
env:
TOKENLAB_MCP_TOOL_PROFILE: "core"
TOKENLAB_API_KEY: "<TOKENLAB_API_KEY>"Hermes는 나열된 env만 서버에 전달하므로, 이 로컬 파일에서 <TOKENLAB_API_KEY>를 본인의 키로 교체하고 공유하지 마세요. hermes mcp test tokenlab을 실행하거나 열려 있는 세션에서 /reload-mcp를 실행하세요. 그런 다음 다음을 시도해보세요:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video는 작업 ID를 반환합니다. 에이전트는 비디오가 준비될 때까지 get_task_status를 호출합니다. Skill 가이드에서 통합 지침을 확인할 수 있습니다. 이 공급자를 선택하기 위해 MCP나 Skills가 반드시 필요한 것은 아닙니다.