AIBOX-K3 Hermes Agent Application Usage

799959745

Hermes Agent (Cloud Compute)

Hermes Agent is an open-source AI agent framework that supports multiple LLM providers. It offers capabilities such as tool calling, scheduled tasks, MCP protocol support, and web access, and can be used from a terminal CLI or integrated into messaging platforms such as Telegram and Discord.

Platform Support

Platform & OS	Supported
K1 Buildroot	❌ No
K1 OpenHarmony	❌ No
K1 Bianbu LXQT/GNOME	✅ Yes
K3 Buildroot	❌ No
K3 OpenHarmony	❌ No
K3 Bianbu LXQT/GNOME	✅ Yes

Installation

Option 1: apt Installation (Recommended)

Install it directly through apt on Bianbu OS:

1. sudo apt update
   
2. sudo apt install hermes-agent

Copy the code

After installation, you can run the hermes command directly without any additional environment configuration.

Option 2: Source Installation (For Developers)

This method is intended for users who need to modify the codebase or contribute to development.

Prerequisites

• Python 3.11+ (uv will download it automatically)
• libffi8 (runtime library, included in the system)
• libffi-dev headers (must be extracted manually, see below)
  

1. Clone the Repositor

1. git clone https://github.com/NousResearch/hermes-agent.git
   
2. cd hermes-agent

Copy the code

2. Install uv

1. curl -LsSf https://astral.sh/uv/install.sh | sh
   
2. source ~/.bashrc

Copy the code

3. Extract libffi-dev Headers

Building cffi and cryptography on riscv64 requires ffi.h, but the system includes only the runtime library and not the header files. Use apt-get download to fetch the .deb package without installing it or requiring sudo, then extract the headers with dpkg-deb -x:

1. apt-get download libffi-dev
   
2. mkdir -p /tmp/libffi-dev
   
3. dpkg-deb -x libffi-dev_*.deb /tmp/libffi-dev

Copy the code

/tmp/libffi-dev is removed after a reboot. If you need to reinstall dependencies, run this step again. Existing virtual environments are not affected.

4. Create a Virtual Environment and Install Dependencies

1. cd hermes-agent
   
2. 
   
3. export PKG_CONFIG_PATH="/tmp/libffi-dev/usr/lib/riscv64-linux-gnu/pkgconfig:$PKG_CONFIG_PATH"
   
4. export C_INCLUDE_PATH="/tmp/libffi-dev/usr/include/riscv64-linux-gnu:$C_INCLUDE_PATH"
   
5. export CPATH="/tmp/libffi-dev/usr/include/riscv64-linux-gnu:$CPATH"
   
6. export LIBRARY_PATH="/tmp/libffi-dev/usr/lib/riscv64-linux-gnu:$LIBRARY_PATH"
   
7. 
   
8. uv venv venv --python 3.11
   
9. source venv/bin/activate
   
10. 
    
11. uv pip install -e ".[cron,cli,dev,mcp,web]"

Copy the code

The voice and messaging extras have limitations on riscv64. See Unavailable Features for details.

Configuration
1. Configure the API Key

Edit ~/.hermes/.env (generated automatically on first run, or create it manually). The following example uses the MiniMax China endpoint.

1. MINIMAX_CN_API_KEY=your_key_here
   
2. MINIMAX_CN_BASE_URL=https://api.minimaxi.com/v1

Copy the code

For a source installation, you can also edit the .env file directly under the project directory:

1. cp .env.example .env

Copy the code

2. Configure the Model

Edit ~/.hermes/config.yaml (generated automatically on first run, or create it manually):

1. model:
   
2.   default: MiniMax-M2.7-highspeed
   
3.   provider: custom
   
4.   base_url: https://api.minimaxi.com/v1
   
5.   api_mode: chat_completions
   
6. 
   
7. custom_providers:
   
8. - name: minimax-cn
   
9.   base_url: https://api.minimaxi.com/v1
   
10.   api_key: your_key_here
    
11.   api_mode: chat_completions
    
12.   model: MiniMax-M2.7-highspeed

Copy the code

The MiniMax API accepts only the plain model name, for example MiniMax-M2.7-highspeed. Provider-prefixed formats such as minimax-cn/MiniMax-M2.7-highspeed are not supported.

Start the Agent

For an apt installation, run:

1. hermes

Copy the code

For a source installation, activate the virtual environment each time you open a new terminal:

1. cd hermes-agent
   
2. source venv/bin/activate
   
3. ./hermes

Copy the code

Supported LLM Providers

Set the corresponding key in .env to switch providers.

Provider	Environment Variable
OpenRouter	OPENROUTER_API_KEY
Google Gemini	GOOGLE_API_KEY
Kimi / Moonshot	KIMI_API_KEY
MiniMax (Global)	MINIMAX_API_KEY
MiniMax (China)	MINIMAX_CN_API_KEY
GLM / z.ai	GLM_API_KEY
Hugging Face	HF_TOKEN

Unavailable Features

The following features are currently unavailable because of riscv64 platform limitations:

Feature	Reason
voice (speech recognition)	ctranslate2 has no riscv64 wheel; faster-whisper depends on it
Local STT (speech-to-text)	Same as above
messaging Discord encryption	pynacl depends on cffi and is skipped because libffi headers are unavailable

Messaging Feature (Optional)

The messaging feature allows Hermes Agent to connect to messaging platforms such as Telegram, Discord, Slack, WhatsApp, Signal, and Matrix. After configuring the bot token for the target platform, you can interact with the agent directly from those applications.

To enable it in a source installation, first set the libffi environment variables, and then install it separately:

1. export PKG_CONFIG_PATH="/tmp/libffi-dev/usr/lib/riscv64-linux-gnu/pkgconfig:$PKG_CONFIG_PATH"
   
2. export LIBRARY_PATH="/tmp/libffi-dev/usr/lib/riscv64-linux-gnu:$LIBRARY_PATH"
   
3. export CPATH="/tmp/libffi-dev/usr/include/riscv64-linux-gnu:$CPATH"
   
4. source venv/bin/activate
   
5. uv pip install -e ".[messaging]"

Copy the code

Start the messaging gateway:

1. ./hermes gateway

Copy the code