Metadata-Version: 2.5
Name: atalk-hermes
Version: 0.1.0a7
Summary: Native encrypted text and multimedia aTalk 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,multimedia
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.0a7
Description-Content-Type: text/markdown

# atalk-hermes

Native aTalk platform plugin for Hermes Agent. Incoming encrypted text, images, video, audio and documents become Hermes gateway events and can use its vision, transcription and document pipelines. Hermes can send generated files back through the same encrypted aTalk conversation.

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

First 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 activation. `ATALK_BASE_URL` defaults to `https://api.atalk.ar`. Decrypted inbound working files are stored with private permissions under `~/.hermes/atalk/media` and cleaned after 24 hours. Override that directory with `ATALK_MEDIA_DIR`.

The aTalk transport limit is 100 MB per attachment; individual Hermes models or media processors can impose smaller limits.
Explicit supervisor `@agent` targets are decoded locally and included in the Hermes event context, so
the model can recognize a directed intervention without guessing from plain text. A targeted response
returns privately to the supervisor; only an unmentioned intervention is relayed to the counterparty.
