Flaq AI 에이전트 가이드

Flaq AI의 API 서비스에서 Hermes Agent를 사용하는 실전 가이드

Flaq AI의 Hermes Agent 호환 엔드포인트를 사용하면 Hermes Agent를 Flaq에 맞게 빠르게 설정하고 터미널에서 모델 서비스에 접근할 수 있습니다. API 키를 설정한 뒤 이 가이드의 예제를 따라 현재 지원되는 모델을 선택하고 설정을 검증하세요.

에이전트 가이드

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

설치

Hermes Agent 설치

시스템에 맞게 Hermes Agent를 설치하고, 필요하면 셸을 다시 불러온 다음, Flaq AI 설정을 추가하기 전에 hermes 명령을 확인합니다. 설치 관리자가 설정 마법사를 열면 Nous Portal 로그인을 건너뛰고 이후 Flaq을 수동으로 구성할 수 있습니다.

1

Hermes Agent 설치

시스템에 맞는 설치 관리자를 선택한 다음 아래 설치 명령을 실행합니다.

  • 설치 관리자가 Hermes 설정 마법사를 열 수 있습니다.
  • Flaq 설정에서는 Nous Portal 로그인을 건너뛰고 아래 수동 구성으로 계속 진행할 수 있습니다.

공식 설치 스크립트

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
2

셸 프로필 다시 불러오기

설치 후 아직 hermes 명령을 사용할 수 없을 때 실행합니다. 셸이 bash를 사용한다면 source ~/.bashrc를 사용하세요.

셸 프로필 다시 불러오기

source ~/.zshrc
3

Hermes Agent 확인

Flaq AI 자격 증명을 추가하기 전에 hermes 명령을 사용할 수 있는지 확인합니다.

설치 확인

hermes --version

설정

Hermes Agent를 Flaq AI에 연결

Flaq의 OpenAI 호환 엔드포인트에서 현재 지원되는 모델을 선택하고, Flaq API 키를 ~/.hermes/.env에 저장한 뒤 config.yaml이 Flaq API 기본 URL을 바라보도록 설정합니다.

안정적인 기본 Hermes Agent 코딩 워크플로에 권장되는 텍스트 모델입니다.

Hermes CLI 명령을 사용해 수동 파일 편집을 줄이고 Flaq API 키와 모델 설정을 기록합니다. 이 작업은 로컬 Hermes 설정을 업데이트하므로 이미 Hermes를 사용 중이라면 먼저 기존 구성을 백업하세요.

Hermes config 명령을 통해 Flaq 키, 선택한 모델, 사용자 지정 공급자, 기본 URL, 컨텍스트 길이를 기록합니다.

Hermes CLI 빠른 설정

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

검증

Hermes Agent에서 Flaq 검증

간단한 Hermes 일회성 명령을 실행합니다. 정상 답변이 오면 Hermes가 Flaq LLM 엔드포인트를 통해 모델을 호출할 수 있다는 뜻입니다.

인터랙티브 모드 시작

hermes

빠른 테스트 명령

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

구성 진단

hermes config check

선택한 모델을 기본값으로 설정

hermes config set model.default gpt-5.4-text-to-text

문제 해결

Hermes Agent FAQ

이 가이드의 설정으로 사용할 경우 token 사용량이 크게 늘어날 수 있습니다.