1. AI application
AboAI
English
  • 中文
  • English
  • Home Page
  • AboAi-API
    • Model
      • Native OpenAI Format
      • Native Gemini Format
    • Chat
      • Native OpenAI Format
      • Native Gemini Format
      • Native Claude Format
      • Responses Request (openai)
    • Audio
      • Native OpenAI Format TTS
      • Native Gemini Format TTS
    • Images
      • Native OpenAI Format Image Generation
      • Native Gemini Format Image Generation
      • Native OpenAI Format Image Editing (JSON)
      • Native OpenAI Format Image Editing (Multipart)
    • Video
      • Seedance2.0 format
        • Create Video Generation Task
        • Query Video Generation Task Status
    • Vector
      • Embeddings
        • Create Embedding
    • Translation
      • Speech Translation
  • AI application
    • AboAI API Integration with Claude Code
    • AboAI API Integration with Cursor
    • AboAI API Integration with Codex-cli
    • AboAI API Integration with Codex Desktop
    • AboAI API Integration with Hermes Agent
  1. AI application

AboAI API Integration with Hermes Agent

Applies to:
Hermes Agent（Nous Research）
AboAI API
Claude / GPT-5
macOS
Windows
Linux
WSL2

I. What is Hermes Agent#

Hermes Agent is an open-source AI Agent framework developed by Nous Research.
Key Features:
Autonomous task execution
Tool Calling
MCP (Model Context Protocol) support
Browser automation
File system operations
Long-term memory
Multi-model support
Official Resources:
Hermes Agent GitHub
Official Resources:
Hermes Agent Docs

II. Prerequisites#

Before you begin, please prepare the following:
ItemDescription
AboAI API Keysk-xxxx
GitRecommended to have installed
Network EnvironmentAccess to GitHub required
Operating SystemmacOS / Windows / Linux

III. macOS Installation Guide#

1. Install Git#

Verify your Git installation:
If it is not installed, run:

2. Install Hermes Agent#

The official recommendation is the one-click installation script:
The installer will automatically handle the setup for:
uv
Python 3.11
Node.js 22
ripgrep
ffmpeg
Playwright
Note: There is no need to manually install Python or Node.js prior to running this script.

3. Reload the Terminal#

Zsh：
Bash：

4. Verify Installation#

Check the installed version:
Diagnose the environment setup:

image.png#

IV. Windows Installation Guide#

Recommended Solution: WSL2#

Official recommendation for Windows users is to prioritize WSL2, though a native Windows solution is available.
Why WSL2?
Best stability
Complete feature availability
Perfectly consistent with the Linux environment
Installing WSL:
Open PowerShell as an Administrator and run:
wsl --install
Restart your computer, then install Ubuntu.
Open your Ubuntu terminal and execute:
Once completed, reload the profile:
Verify the installation:

Windows Native Installation (Beta)#

PowerShell：
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
The installer will automatically configure:
uv
Python 3.11
Node.js 22
ripgrep
ffmpeg
PortableGit
After the installation finishes, restart your PowerShell window and verify:
hermes doctor

V. Installation via pipx (Optional)#

If you prefer not to use the automated script method:
Mac：
Windows：
python -m pip install --user pipx

python -m pipx ensurepath
Install Hermes:
Verify the setup:

VI. Get AboAI API Information#

Go to the AboAI Open Platform to apply for your secret key (sk).
aboai Open Platform
image-20260514140602533.png
image-20260514140819323.png
Obtain the following values:
Configuration ItemExample
Base URLhttps://api.aboai.ai
API Keysk-xxxx
ModelClaude Opus 4.6 / GPT 5.2 ...

VII. Configure AboAI#

Navigate to your configuration directory (typically located in the user's home directory):
Edit the config.yaml file and append the following configuration block:

VIII. Start Hermes & Verify#

Launch the interactive chat interface:
or:
Default Model:
image.png
Switch Configured Models:
image.png
Switch to any model provided by AboAI:
image.png
Press Enter.
image.png
Press Enter and use the arrow keys to freely navigate through the models supplied by AboAI.
image.png
Test functionality:

image.png#

IX. Common Commands#

View Available Models:
Configure Tools:
Rerun Setup Wizard:
View Current Configuration:
Diagnose Environment:
Upgrade Framework:

X. Troubleshooting / FAQ#

hermes: command not found#

Your terminal profile needs a manual refresh. Run:
or:

Invalid API Key#

Double-check your sk-xxxx key to ensure:
The account has an active balance quota.
It is not expired.
There are no trailing whitespaces or hidden characters.

Model Not Recognized?#

If you receive a model configuration error like:
✗ Model GPT‑5.2‑Chat was not found in this provider's model listing. Similar models: GPT-5.2-Chat, GPT-5.2, GPT-5.5
This is likely caused by an encoding mismatch due to copying and pasting text. Although the strings look identical, the character encodings differ. To resolve this, manually type out the model name into the configuration file instead of copying it.

Installation Errors#

Run the built-in health check to inspect diagnostic data:

XI. Summary#

Official Quick Install Commands:
macOS / Linux / WSL2：
Windows：
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
Once installed, complete the initialization wizard and integrate AboAI to gain immediate access to:
Claude
GPT-5
Along with core capabilities:
MCP
Browser Tool
Tool Calling
Agent Workflow
Your Hermes Agent + AboAI environment is now fully connected and ready to roll!
Modified at 2026-06-16 12:36:05
Previous
AboAI API Integration with Codex Desktop
Built with