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

Scroll inside the canvas to pan

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.

Linked from

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.

In this research stack

Features and peers linked from the catalog map — not a second product surface.

Features it supports

Same cell

Stack

Document management

No DM vendor crosswalk edges yet.

Source

Primary repo github.com/truera/trulens · Open Source

technologies/trulens/README.md

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