Skip to main content
Opik Documentation
current

Search documentation

Type to search this documentation.

On this pageOverview

Observability for Hermes with Opik

Install and configure the opik-hermes plugin to export LLM, tool, and agent traces to Opik.

Hermes can send trace data to Opik through the plugin package opik-hermes.

This integration captures:

  • A root trace per agent turn, organized by Hermes session_id
  • LLM spans (type=llm): messages, assistant output, model/provider, token usage, and USD cost
  • Tool spans (type=tool): tool arguments and results
  • The Hermes agent framework installed.
  • Opik project/workspace details (for cloud or enterprise deployments).
  1. 1. Install the plugin

    Bash
    pip install opik-hermes

    Installing the package automatically registers the plugin with Hermes.

  2. 2. Enable the plugin

    Add opik to the enabled plugins in ~/.hermes/config.yaml:

    YAML
    plugins:
      enabled: [opik]
  3. 3. Configure Opik credentials

    Set the Opik environment variables in ~/.hermes/.env.

    For a local open-source Opik deployment:

    Bash
    OPIK_URL_OVERRIDE=http://localhost:5173/api
    OPIK_PROJECT_NAME=hermes

    For Comet-hosted Opik:

    Bash
    OPIK_API_KEY=your-api-key
    OPIK_WORKSPACE=your-workspace

Run a Hermes chat session and verify traces appear in the configured Opik project dashboard.

For OTEL-native pipelines, see OpenTelemetry integration.

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu