Set up Hermes Agent
The example uses Kimi K3.1 Pro (k3.1-pro). Get an I Code Easy API key from API keys.
Installation
Run this command on Linux, macOS, or WSL. For native Windows, follow the PowerShell steps in the official installation guide.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Hermes Agent
This configuration sends Chat Completions requests to /v1/chat/completions.
Merge the configuration into ~/.hermes/config.yaml. On native Windows, the default directory is %LOCALAPPDATA%\hermes. If you set HERMES_HOME, use that directory.
providers:
icodeeasy:
api: https://api.icodeeasy.cc/v1
key_env: ICODEEASY_API_KEY
transport: chat_completions
model:
default: k3.1-pro
provider: custom:icodeeasy
Add this line to .env in the same directory and replace YOUR_API_KEY with your key.
ICODEEASY_API_KEY=YOUR_API_KEY
Start a session
Run hermes to start a session. To switch in an open session, use /model custom:icodeeasy:k3.1-pro.
Verify your first request
Send a short text prompt and check the model and request status in Usage logs. For a 401 error, check the key. For a model or permission error, check the model ID and selected endpoint. If the connection is unstable, try https://jp.icodeeasy.cc or https://sg.icodeeasy.cc and keep the /v1 path.
Official client documentation
Related guides
Kimi Code Setup: API Key, K3.1 Pro, and Claude Code
Set up Kimi Code CLI or Claude Code with K3.1 Pro. Compare persistent and temporary settings, verify your first call, and fix 401, model, and URL errors.
Chat Completions
Send a conversation using the OpenAI Chat format. Check that your model and selected endpoint support the Chat protocol before sending the request.
How do I troubleshoot slow connections or failed requests?
Match 401, 403, 429, timeouts, and Gemini path errors before changing hosts. Switch to the jp or sg backup domain only after the network is the problem.