mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-05-05 02:07:34 +08:00

Files

kshitijk4poor d8c2c77be6 feat(plugins): add optional-plugins/ discovery + langfuse_tracing as first official optional plugin

Introduces optional-plugins/ — a new category for plugins that ship with
the repo but are NOT auto-discovered. They live alongside the code but only
land in ~/.hermes/plugins/ (and thus get loaded) when the user explicitly
installs them.

Core changes:
- optional-plugins/observability/langfuse-tracing/ — langfuse tracing plugin
  (pre/post LLM + tool hooks, usage/cost normalization, fail-open when SDK
  missing). NOT in plugins/ so zero import overhead on devices that don't
  want it.
- hermes_cli/plugins_cmd.py — official install path: _resolve_official_plugin()
  recognises 'official/<category>/<name>' identifiers and copies from
  optional-plugins/ into ~/.hermes/plugins/ (no git clone, no network).
  _list_official_plugins() enumerates available optional plugins.
  cmd_list(available=True) shows not-yet-installed official plugins.
- hermes_cli/main.py — hermes plugins list --available flag
- hermes_cli/tools_config.py — Langfuse Observability in TOOL_CATEGORIES;
  post_setup handler installs the langfuse SDK and runs cmd_install()
- hermes_cli/config.py — Langfuse credentials in OPTIONAL_ENV_VARS;
  optional tuning keys in _EXTRA_ENV_KEYS

User flows:
  hermes plugins install official/observability/langfuse-tracing
  hermes plugins list --available
  hermes tools  (-> Langfuse Observability -> credentials -> auto-installs)

Closes #15764

2026-04-28 11:52:42 +05:30

1001 B

Raw Blame History

After installing langfuse

Langfuse tracing is now installed and enabled for your Hermes profile.

Required credentials

Set these in ~/.hermes/.env (or via hermes tools → Langfuse Observability):

HERMES_LANGFUSE_PUBLIC_KEY=pk-lf-...
HERMES_LANGFUSE_SECRET_KEY=sk-lf-...
HERMES_LANGFUSE_BASE_URL=https://cloud.langfuse.com   # or your self-hosted URL

Verify

hermes plugins list          # langfuse should appear as enabled
hermes chat -q "hello"       # then check Langfuse for a "Hermes turn" trace

Optional settings

HERMES_LANGFUSE_ENV=production       # environment tag
HERMES_LANGFUSE_RELEASE=v1.0.0      # release tag
HERMES_LANGFUSE_SAMPLE_RATE=0.5     # sample 50% of traces
HERMES_LANGFUSE_MAX_CHARS=12000     # max chars per field (default: 12000)
HERMES_LANGFUSE_DEBUG=true          # verbose plugin logging

Dependencies

The langfuse Python SDK is required. Install it into your Hermes venv:

pip install langfuse

1001 B Raw Blame History