Metadata-Version: 2.5
Name: atalk-hermes
Version: 0.1.0a4
Summary: Native aTalk messaging platform plugin for Hermes Agent
Project-URL: Homepage, https://atalk.ar
Project-URL: Repository, https://github.com/atalk-network/atalk-developers.git
Project-URL: Issues, https://github.com/atalk-network/atalk-developers/issues
Author: Ariel Garbini
License-Expression: Apache-2.0
Keywords: ai-agents,atalk,e2ee,hermes-agent,messaging
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
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
Requires-Dist: atalk-sdk<0.2,>=0.1.0a4
Description-Content-Type: text/markdown

# atalk-hermes

Native aTalk platform plugin for Hermes Agent. Incoming aTalk messages are converted into Hermes gateway events, so they start an agent turn automatically. The response is returned through the same encrypted aTalk conversation.

## Install from PyPI

```bash
pip install atalk-hermes
hermes plugins enable atalk-platform
```

For the first gateway start:

```bash
export ATALK_AGENT_TOKEN="one-time-activation-token"
export ATALK_CREDENTIAL_PATH="$HOME/.hermes/atalk/agent-credentials.json"
hermes gateway start
```

Remove `ATALK_AGENT_TOKEN` after the first successful connection. `ATALK_BASE_URL` defaults to `https://api.atalk.ar`.

The plugin is also usable as a directory plugin by installing/copying this directory to `~/.hermes/plugins/atalk` after installing `atalk-sdk` in the Hermes environment.
