Technology · Agentic → Evaluations · Open Source · wiki:deep

TruLens

TruLens is an open-source stack that finds where an agent fails and where cost can drop without losing quality. It is OpenTelemetry-native: instrument apps with decorators, score steps with self-explaining LLM judges, compare versions, and export traces to any OTLP backend. Evaluations run inline as traces land or in batch over datasets.

Core concepts include feedback/metrics, the RAG triad, and honest/harmless/helpful evals. Provider and framework extras install as separate packages (trulens-providers-*, trulens-apps-langchain, etc.). MIT licensed (TruEra / Snowflake ecosystem).

Why it matters here

Eval without step-level traces cannot distinguish a bad retrieval from a bad generator or a bad tool call. TruLens is the research pick when Evaluations must attach scores to OTEL spans and compare app versions on quality × latency × cost — complementary to Promptfoo/DeepEval CI matrices and to process mining (pm4py) on XES.

How it works

  1. pip install trulens (+ provider/app extras).
  2. @instrument spans (retrieval, generation, tools, MCP, …).
  3. Attach Metrics/feedback functions (inline recorder or batch RunConfig).
  4. Compare versions on a leaderboard; export OTLP elsewhere if needed.

Related: abm-agent-behavior-mining · agent-evaluation · deepeval · topics/32-eval-harnesses

Flow

When to reach for it

  • Use when: you need tracing + LLM judges on agent/RAG steps, version compare, or OTEL interoperability.
  • Skip when: you only need declarative YAML red-team CLI (promptfoo), pytest metric suites without tracing (deepeval), or XES process mining (pm4py).
  • Prefer instead: Langfuse/Phoenix-class tools if you already standardized another OTEL UI; keep TruLens when feedback functions + agent GPA-style evals matter.

Limits

  • Package sprawl: providers/apps are split — missing extras silently disable features.
  • Judge calibration: marketed human-agreement figures are context-specific; re-validate on your goldens.
  • Not the ledger: traces/scores are evidence, not declared authority or money movement.
  • Overlap with observability cell: clarify whether TruLens is eval or ops UI in the install to avoid two systems of dashboards.

What we checked

Claims below are backed by science sources on disk.

Product / tracing + feedback

truera/trulens · MODERATE

“The results… show that our proposed metrics are much closer aligned with the human judgements than the predictions from the two baselines.”

Docs / core concepts

TruLens documentation · MODERATE

“For faithfulness and context relevance, the two annotators agreed in around 95% of cases. For answer relevance, they agreed in around 90% of the cases.”

Peer contrast

RAGAS contrast · MODERATE

“Ragas is available at https://github.com/explodinggradients/ragas.”
Research inventory

9 tags · 14 out · 15 in · 3 artifacts · 1 gaps · 30 corpus docs

Catalog tags

landscape.layer
Agentic
landscape.subcategory
Evaluations
license_tag
Open Source
maps.dm
absent
maps.features
7
one_liner
Agentic
review.depth
science
slug
trulens
title
TruLens

Artifacts

  • dm_map · absent
  • features_map · present · technologies/trulens/features.md
  • readme · present · technologies/trulens/README.md

Out · alternative_to

Out · maps_to

In · alternative_to

In · in_stack

In · maps_to

Corpus tags

category
Agentic → Evaluations
dedication
open-source
feature
outcome-verification
r2-30-evaluator-critic
r2-32-eval-harnesses
r2-42-intervention-preassessment
r2-47-trace-maturity-gate
testing-debugging-optimization
wt-test-debug-evaluate
kind
map_edge
tech_features
tech_quote
tech_readme
tech_science_source
tech_section
needs_deepen
false
quality
ok
section
Evidence
Features map
GitHub map
How it works
Limits & failure modes
Links
Scientific notes
What it is
When to use / skip
Why it matters here
slug
trulens
source_id
ragas-contrast
trulens-docs
trulens-github
technology
trulens

Corpus documents (30)

map_edge · 7

  • trulens → outcome-verification
  • trulens → r2-30-evaluator-critic
  • trulens → r2-32-eval-harnesses
  • trulens → r2-42-intervention-preassessment
  • trulens → r2-47-trace-maturity-gate
  • trulens → testing-debugging-optimization
  • trulens → wt-test-debug-evaluate

tech_features · 1

  • TruLens · features

tech_quote · 8

  • TruLens · ragas-contrast
  • TruLens · ragas-contrast
  • TruLens · ragas-contrast
  • TruLens · trulens-docs
  • TruLens · trulens-docs
  • TruLens · trulens-docs
  • TruLens · trulens-github
  • TruLens · trulens-github

tech_readme · 1

  • TruLens

tech_science_source · 3

  • TruLens · ragas-contrast
  • TruLens · trulens-docs
  • TruLens · trulens-github

tech_section · 10

  • TruLens · Evidence
  • TruLens · Features map
  • TruLens · GitHub map
  • TruLens · How it works
  • TruLens · Limits & failure modes
  • TruLens · Links
  • TruLens · Scientific notes
  • TruLens · What it is
  • … +2 more