Metadata-Version: 2.4
Name: hermes-baiduapp
Version: 0.1.3
Summary: Baidu App platform plugin for Hermes Agent (polling mode, no webhook)
License: MIT
Keywords: baidu,chatbot,gateway,hermes,hermes-agent
Requires-Python: >=3.9
Requires-Dist: bce-python-sdk
Description-Content-Type: text/markdown

# hermes-baiduapp

Baidu App platform plugin for [Hermes Agent](https://github.com/NousResearch/hermes-agent).

Uses polling mode (`/channel/msg/poll`) to receive messages. No webhook required.

## Install

```bash
uv pip install hermes-baiduapp --python ~/.hermes/hermes-agent/venv/bin/python
```

or, inside the Hermes Python environment:

```bash
pip install hermes-baiduapp
```

## Enable

Hermes discovers pip-installed plugins through the `hermes_agent.plugins` entry-point group, but entry-point plugins must still be enabled in `~/.hermes/config.yaml`:

```yaml
plugins:
  enabled:
    - baiduapp
```

## Configure

Add to `~/.hermes/.env`:

```env
BAIDU_APP_KEY=your-app-key
BAIDU_APP_SECRET=your-app-secret
# Optional:
BAIDU_API_BASE=https://claw.baidu.com
GATEWAY_ALLOW_ALL_USERS=true
```

Then restart the gateway:

```bash
hermes gateway run
```

## Protocol

- Receive: polling `POST /channel/msg/poll`
- Send: callback `POST /channel/msg/callback`
- Auth: `Authorization: Bearer SHA1(ak + sk + timestamp + nonce)`
