Flaq AI Agent Guide

Practical Guide for using Hermes Agent with Flaq AI's API Services

Use Flaq AI's Hermes Agent-compatible endpoint to quickly configure Hermes Agent with Flaq and access our model services from the terminal. After configuring your API key, follow the examples in this guide to choose a currently supported model and verify the setup.

Agent guides

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

Install

Install Hermes Agent

Install Hermes Agent for your system, reload your shell if needed, then verify the hermes command before adding Flaq AI settings. If the installer opens the setup wizard, you can skip Nous Portal login and configure Flaq manually afterward.

1

Install Hermes Agent

Choose the installer that matches your system, then run the install command below.

  • The installer may open the Hermes setup wizard.
  • For Flaq setup, you can skip Nous Portal login and continue with the manual config below.

Official install script

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

Reload shell profile

Run this after installation if the hermes command is not available yet. Use source ~/.bashrc if your shell uses bash.

Reload shell profile

source ~/.zshrc
3

Verify Hermes Agent

Confirm the hermes command is available before adding Flaq AI credentials.

Verify installation

hermes --version

Configure

Connect Hermes Agent to Flaq AI

Choose a model currently supported by Flaq's OpenAI-compatible endpoint, store your Flaq API key in ~/.hermes/.env, and point config.yaml to the Flaq API base URL.

Recommended text model for a dependable default Hermes Agent coding workflow.

Use Hermes CLI commands to write the Flaq API key and model settings with fewer manual file edits. This updates your local Hermes settings, so back up existing config first if you already use Hermes.

Writes the Flaq key, selected model, custom provider, base URL, and context length through Hermes config commands.

Hermes CLI quick setup

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

Verify

Verify Flaq in Hermes Agent

Run a quick Hermes one-shot command. A normal answer means Hermes can call models through the Flaq LLM endpoint.

Start interactive mode

hermes

Quick test command

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

Configuration diagnostics

hermes config check

Set the selected model as default

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

Troubleshooting

Hermes Agent FAQ

Using this guide's setup may significantly increase token usage.