Metadata-Version: 2.4
Name: hermes-plugin-pushary
Version: 0.2.0
Summary: Pushary push notifications plugin for Hermes Agent
Author-email: RalphNex OU <business@pushary.com>
License: MIT
Project-URL: Homepage, https://pushary.com
Project-URL: Repository, https://github.com/pushary/pushary
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Pushary Plugin for Hermes Agent

Push notifications and human-in-the-loop for [Hermes Agent](https://hermes-agent.nousresearch.com/) via [Pushary](https://pushary.com).

## Install

```bash
pip install hermes-plugin-pushary
```

Or manually:

```bash
cp -r pushary_plugin ~/.hermes/plugins/pushary
cp plugin.yaml ~/.hermes/plugins/pushary/
```

Then enable:

```bash
hermes plugins enable pushary
```

## Setup

Set your API key:

```bash
export PUSHARY_API_KEY="pk_xxx.sk_xxx"
```

Get a key at [pushary.com/sign-up](https://pushary.com/sign-up?from=hermes).

## Tools

| Tool | Description |
|------|-------------|
| `pushary_notify` | Send a push notification with optional rich context |
| `pushary_ask` | Ask a question via push (yes/no, multiple choice, or free text) |
| `pushary_wait` | Wait for the user's answer |
| `pushary_cancel` | Cancel a pending question |

## Auto-Notifications

The plugin automatically sends push notifications when tools return errors (up to 3 per session).

Set `PUSHARY_AUTO_NOTIFY_SESSION_END=1` to also get notified when a session ends.

Set `PUSHARY_AGENT_NAME` to identify this Hermes instance in notifications (e.g., `"Hermes - daily-briefing"`).

## License

MIT
