grix-hermes 1.0.4

Grix/aibot protocol platform adapter plugin for Hermes Agent

grix-hermes

Grix/aibot protocol platform adapter plugin for Hermes Agent.

Installation

pip install grix-hermes

Or install it as a Hermes plugin:

hermes plugins install <git-url-or-owner/repo> --enable

For local development:

hermes plugins install file:///absolute/path/to/grix-hermes --enable

获取连接参数

访问 https://grix.dhf.pub/，在 AI 标签页中创建一个 API Agent 类型的 Agent，即可获得以下三个参数：

• GRIX_ENDPOINT — WebSocket 连接地址
• GRIX_AGENT_ID — Agent ID
• GRIX_API_KEY — API Key

Setup

将获得的参数配置为环境变量（或通过 Hermes 配置文件设置）：

export GRIX_ENDPOINT=wss://your-grix-endpoint
export GRIX_AGENT_ID=your-agent-id
export GRIX_API_KEY=your-api-key

Then enable the plugin in ~/.hermes/config.yaml:

plugins:
  enabled:
    - grix-hermes

Or install as a user plugin:

cp -r /absolute/path/to/grix-hermes ~/.hermes/plugins/grix-hermes/

Provided Tools

Tool	Description
grix_invoke	WS-based operations: send/delete messages, query contacts/sessions, manage groups, admin agents
grix_auth	HTTP auth: send email code, register, login, create/rotate agent API keys
grix_card	Generate Grix deep-link cards for conversations, profiles, and install status
grix_egg	Agent incubation: 7-step bootstrap (detect → install → create → bind → soul → gateway → accept)

Plugin Skills

After installing the plugin, Hermes can load these namespaced skills:

• grix-hermes:group-ops — group creation, member management, mute and speaking controls
• grix-hermes:agent-bootstrap — install, bind, enable, and verify a Grix-backed Hermes profile

License

MIT