Back to packageRELEASE DETAILS

0.2.2

PyPI

agentmetrics-hermes

AgentMetrics observability plugin for Hermes agents

Published22 Jun 2026

Direct dependencies7

Transitive dependenciesNot calculated

README

Version 0.2.2 documentation

agentmetrics-hermes

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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 7

Native requirements

7 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
agentmetrics-shared Environment { "extras": "", "marker": null, "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`agentmetrics-shared>=0.2.0`	runtime
cryptography Environment { "extras": "", "marker": "extra == \"crypto\"", "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`cryptography>=41.0; extra == "crypto"`	runtime
pytest Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`pytest>=8.0; extra == "dev"`	runtime
pytest-cov Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`pytest-cov>=5.0; extra == "dev"`	runtime
ruff Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`ruff>=0.11.0; extra == "dev"`	runtime
mypy Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`mypy>=1.10; extra == "dev"`	runtime
hypothesis Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.11", "evaluation": "NOT_EVALUATED" }	`hypothesis>=6.0; extra == "dev"`	runtime