Skip to main content

agentmetrics-hermes

PyPI License: MIT

AgentMetrics observability plugin for Hermes agents. Auto-discovered via the hermes_agent.plugins entry-point — no code changes needed.


Install

pip install agentmetrics-hermes

Configuration

Create ~/.config/hermes/agentmetrics.yaml:

api_key: am_your_key
server_url: http://localhost:4000
agent_id: my-hermes-agent
environment: production

Or set environment variables (take precedence over the file):

Variable Description
AGENTMETRICS_API_KEY API key
AGENTMETRICS_SERVER_URL Server URL
AGENTMETRICS_AGENT_ID Agent identifier
AGENTMETRICS_ENVIRONMENT Deployment environment

What gets tracked

Metric Description
input_tokens / output_tokens Aggregated LLM token usage
cache_read_tokens / cache_write_tokens Prompt cache statistics
estimated_cost_usd Computed from model pricing
duration_ms Session wall-clock time
tool_calls / tool_errors Per-step tool tracking
llm_calls Number of model API requests
secrets_blocked_count Credentials redacted before transmission
error Exception message on failure (secrets scrubbed)

Durability

Events are written to a local WAL before transmission. If the server is unreachable the plugin retries automatically via an internal circuit breaker. Events that exhaust all retries go to a dead-letter queue and are surfaced as audit_dlq_alert events.


Security

All event payloads are scanned for API keys, JWTs, and passwords before transmission. Set redaction_mode: debug in the config to disable scrubbing during local development (expires automatically after a configurable TTL).


License

MIT

Metadata

Release files for agentmetrics-hermes 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentmetrics-hermes 0.2.2
File Size Uploaded
agentmetrics_hermes-0.2.2.tar.gz 30.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentmetrics-hermes 0.2.2
File Interpreter ABI Platform
agentmetrics_hermes-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 57.7 kB

Release files / agentmetrics_hermes-0.2.2.tar.gz

Download URL agentmetrics_hermes-0.2.2.tar.gz
Size 30.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f7c1f284ebea03bb3f8d20ed9a1fcad08f008f729801dbab2c92696e95033821
BLAKE2b-256 checksum
How to use checksums
a08a66bdcad4c1c2b78bceb43bb8641bad566864e4995686bda7dd01124a62bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / agentmetrics_hermes-0.2.2-py3-none-any.whl

Download URL agentmetrics_hermes-0.2.2-py3-none-any.whl
Size 26.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4374018ff7d048e5568fdb994ce0949dbbbe3d387b63498a4630a6796521cc22
BLAKE2b-256 checksum
How to use checksums
5d0ff29bd2b50f059caec3595e91a7769ba2debab3f3c8999091b1b839245d4c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page