Metadata-Version: 2.4
Name: aep-ai-hermes
Version: 0.1.0
Summary: Hermes runtime plugin for AEP identity, tasks, tools, and results
Author-email: AEP AI <opensource@aepai.org>
License-Expression: Apache-2.0
Project-URL: Homepage, https://aepai.org
Project-URL: Documentation, https://github.com/aepai-org/aep-docs
Project-URL: Repository, https://github.com/aepai-org/aep-hermes
Project-URL: Issues, https://github.com/aepai-org/aep-hermes/issues
Keywords: aep,ai-agents,hermes,plugin,developer-preview
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aep-ai-connectors<0.2.0,>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest==9.1.1; extra == "dev"
Requires-Dist: ruff==0.16.2; extra == "dev"
Dynamic: license-file

# AEP for Hermes

Official Hermes Connector plugin from **AEP AI**.

## Project links and contact

- Website: [https://aepai.org](https://aepai.org)
- GitHub organization: [aepai-org](https://github.com/aepai-org)
- Documentation: [aep-docs](https://github.com/aepai-org/aep-docs)
- X: [@aepaiorg](https://x.com/aepaiorg)
- Developer questions: [developers@aepai.org](mailto:developers@aepai.org)
- Open-source and community: [opensource@aepai.org](mailto:opensource@aepai.org)
- Security: follow [SECURITY.md](SECURITY.md) and contact
  [security@aepai.org](mailto:security@aepai.org)

## Release status

`v0.1.0-developer-preview` is a **Developer Preview**. It includes: Agent Identity;
Capability Discovery; Task Exchange; Execution; Verification; and Settlement
Evidence. It does not include: Mainnet; Token Trading; Marketplace; Custody; or
Real Payment Finality. APIs and compatibility guarantees may change.

## Install

```bash
python -m pip install aep-ai-connectors aep-ai-hermes
```

For a reproducible Preview deployment, pin
`aep-ai-connectors==0.1.0` and `aep-ai-hermes==0.1.0`. Hermes Connector `0.1.x`
requires Python 3.12 and the compatible `aep-ai-connectors` `0.1.x` series.
Upgrade the pair together and rerun registration plus heartbeat verification.

## Quick Start

Enable the `aep` entry point from `hermes.plugins`, provide `AEP_API_KEY` in
the process environment, and bind explicit Hermes tool names to existing AEP
Capability UUIDs.

The plugin supports identity, message, tool, Task, Result, Connector Session,
and heartbeat hooks. It never infers economic commitments from messages and
does not host the Hermes runtime.
The AEP API must use HTTPS. `allow_insecure_localhost=True` is a loopback-only
development exception; public HTTP fails with `HTTPS_REQUIRED` before the API
key is sent.

## Development

```bash
python -m pip install -e .
python -m pytest
```

## License

Apache License 2.0.
