Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 10 additions & 26 deletions agentarts-memory-plugins/agentarts-memory-hermes/README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,36 +20,20 @@ A Hermes Memory Provider plugin that uses Huawei Cloud AgentArts Memory as the l
| Parameter | Description |
|---------------------------------|------------------------------------|
| `AGENTARTS_MEMORY_SPACE_ID` | AgentArts memory space ID |
| `HUAWEICLOUD_SDK_MEMORY_API_KEY`| AgentArts memory space API Key |
| `HUAWEICLOUD_SDK_MEMORY_API_KEY`| AgentArts memory space API Key |
| `HUAWEICLOUD_SDK_REGION` | Region (default `cn-southwest-2`) |

## Installation

There are two installation methods — choose either one.

### Option 1: Install as a memory provider

Copy the plugin directory to Hermes' memory provider plugin path:
Copy the plugin directory `agentarts-memory-hermes` to Hermes' memory provider plugin path and rename it to `agentarts-memory`:

```bash
cp -r agentarts-memory-hermes ~/.hermes/hermes-agent/plugins/memory/
cp -r agentarts-memory-hermes ~/.hermes/hermes-agent/plugins/memory/agentarts-memory
```

Configure interactively via `hermes memory setup`, or manually set the environment variables above. Follow the prompts to select `agentarts_memory` and complete configuration.

### Option 2: Install as a general plugin

Copy the plugin directory to Hermes' general plugin path and register via the `hermes plugins` command:

```bash
cp -r agentarts-memory-hermes ~/.hermes/plugins/
```

Configure interactively via `hermes plugins`, or manually set the environment variables above. Follow the prompts to select `agentarts_memory` and complete configuration.

## Configuration

During configuration, you will be prompted to enter the API Key, Space ID, etc. Sensitive fields (API Key) are written to `.env`, while non-sensitive config (`space_id`, `region`) is written to `$HERMES_HOME/agentarts.json`.
Configure interactively via the `hermes memory setup` command. Follow the prompts to select `agentarts-memory`, then enter the correct parameters to complete configuration.

## Tools

Expand All @@ -74,11 +58,11 @@ Get a list of AgentArts memory summaries.

After the plugin is registered, the following CLI subcommands are available (only when the provider is active):

| Command | Description |
|---|---|
| `hermes agentarts_memory status` | Show provider status and environment variable configuration |
| `hermes agentarts_memory config` | Show saved non-sensitive configuration |
| `hermes agentarts_memory test` | Test provider connectivity |
| Command | Description |
|------------------------|----------------------------|
| `hermes memory status` | Show provider status |
| `hermes memory setup` | Configure the provider |
| `hermes memory off` | Disable the provider |

## Architecture

Expand Down Expand Up @@ -116,5 +100,5 @@ Check:

```bash
pip install -e ".[dev]"
pytest tests/unit/ -v
pytest tests/agentarts-memory-hermes/ -v
```
33 changes: 10 additions & 23 deletions agentarts-memory-plugins/agentarts-memory-hermes/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,30 +26,16 @@ Hermes Memory Provider 插件,将华为云 AgentArts Memory 作为 Hermes Agen

## 安装

有两种安装方式,任选其一。

### 方式一:作为 memory provider 安装

将插件目录复制到 Hermes 的 memory provider 插件路径:

```bash
cp -r agentarts-memory-hermes ~/.hermes/hermes-agent/plugins/memory/
```
通过 `hermes memory setup` 交互式配置,或手动设置上述环境变量。 按提示选择 `agentarts_memory` 并完成配置。

### 方式二:作为通用插件安装

将插件目录复制到 Hermes 的通用插件路径,通过 `hermes plugins` 命令注册:
将插件目录agentarts-memory-hermes复制到 Hermes 的 memory provider 插件路径并重命名为agentarts-memory:

```bash
cp -r agentarts-memory-hermes ~/.hermes/plugins/
cp -r agentarts-memory-hermes ~/.hermes/hermes-agent/plugins/memory/agentarts-memory
```

通过 `hermes plugins` 交互式配置,或手动设置上述环境变量。 按提示选择 `agentarts_memory` 并完成配置。

## 配置

配置过程中会提示输入 API Key、Space ID 等。敏感字段(API Key)写入 `.env`,非敏感配置(`space_id`、`region`)写入 `$HERMES_HOME/agentarts.json`
通过命令 `hermes memory setup` 进行交互式配置,按提示选择 `agentarts-memory` 后,输入正确的参数完成配置

## 工具说明

Expand All @@ -74,11 +60,12 @@ cp -r agentarts-memory-hermes ~/.hermes/plugins/

插件注册后提供以下 CLI 子命令(仅在 provider 活跃时可用):

| 命令 | 说明 |
|---|---|
| `hermes agentarts_memory status` | 显示 provider 状态和环境变量配置 |
| `hermes agentarts_memory config` | 显示已保存的非敏感配置 |
| `hermes agentarts_memory test` | 测试 provider 连通性 |
| 命令 | 说明 |
|-------------------------|------------------|
| `hermes memory status` | 查看 provider 状态 |
| `hermes memory setup` | 配置 provider |
| `hermes memory off` | 禁用 provider |


## 架构说明

Expand Down Expand Up @@ -116,5 +103,5 @@ AgentArts Memory 从对话消息生成记忆需要时间(约 30 秒)。`sync

```bash
pip install -e ".[dev]"
pytest tests/unit/ -v
pytest tests/agentarts-memory-hermes/ -v
```
132 changes: 0 additions & 132 deletions agentarts-memory-plugins/agentarts-memory-hermes/cli.py

This file was deleted.

Loading
Loading