Hyperlake Telemetry SDK for Python

hyperlake-telemetry sends standards-compatible OTLP/HTTP JSON and can attach events or immutable artifacts to the same pipeline. It does not replace the OpenTelemetry SDK: applications with existing instrumentation should continue using their normal exporter and use this package only for run context, stable event identity, evaluations, and artifact attachment.

pip install hyperlake-telemetry

from hyperlake_telemetry import Client, Privacy

client = Client(
    base_url="https://us.hyperlake.cloud",
    tenant_id="tenant-public-id",
    pipeline_id="pipeline-public-id",
    protocol_token="write-only-protocol-token",
    tenant_jwt="short-lived-jwks-jwt",
    privacy=Privacy(capture_content=False),
)

with client.run("invoice-agent", goal_id="goal-42") as run:
    with run.span("lookup-account", kind="RETRIEVER"):
        pass
    run.evaluate("groundedness", score=0.97, label="pass")

client.flush()

The authenticated credential determines the authoritative tenant and pipeline. The IDs supplied by the application are routing hints and must match the token. Prompt, response, tool argument, and tool result content is suppressed by default. Set capture_content=True only after applying an approved data policy.

See the repository integration guides for Temporal, Langflow, OpenInference, Collector, and Alloy examples.