Metadata-Version: 2.4
Name: grix-hermes
Version: 1.0.0
Summary: Grix/aibot protocol platform adapter plugin for Hermes Agent
License-Expression: MIT
Keywords: hermes,grix,aibot,chatbot,agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.9
Provides-Extra: yaml
Requires-Dist: pyyaml>=6.0; extra == "yaml"

# grix-hermes

Grix/aibot protocol platform adapter plugin for Hermes Agent.

## Installation

```bash
pip install grix-hermes
```

## Setup

Set the following environment variables (or configure via Hermes config):

```bash
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`:

```yaml
plugins:
  enabled:
    - grix-platform
```

Or install as a user plugin:

```bash
cp -r grix_hermes ~/.hermes/plugins/grix-platform/
```

## 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) |

## License

MIT
