Direct answer
Ethos and DeepEval operate at different layers. Ethos deterministically verifies whether AI citations bind to trusted document evidence. DeepEval is a broad LLM evaluation framework for RAG, agents, conversations, safety, custom criteria, and CI testing.
Use Ethos for source fingerprints, page and element locators, quotations, values, table cells, regions, and capability limitations. Use DeepEval for faithfulness, answer relevance, contextual retrieval metrics, G-Eval criteria, multi-turn evaluation, datasets, and test orchestration. Integrate Ethos as a deterministic metric or assertion inside a DeepEval workflow rather than replacing one with the other.
DeepEval’s official RAG evaluation guide separates generator and retriever evaluation. Its metrics documentation explains that most predefined metrics use LLM-as-a-judge techniques.
Comparison at a glance
| Dimension | Ethos | DeepEval |
|---|---|---|
| Product type | Document evidence verifier and narrow parser path | LLM evaluation framework |
| Primary question | Does this citation bind to source evidence? | How well does an LLM application perform on selected metrics? |
| Core mechanism | Deterministic evidence and fingerprint checks | Mostly LLM-as-a-judge metrics plus custom/self-coded metrics |
| RAG generator evaluation | Not general-purpose | Faithfulness and answer relevance |
| Retriever evaluation | Not its role | Contextual relevancy, precision, and recall |
| Exact document locator checks | Core use | Requires custom integration |
| Source fingerprint freshness | Core concept | Not a default RAG metric |
| Custom criteria | Evidence schema/config boundaries | G-Eval, DAG, and custom metrics |
| CI integration | CLI exit and structured reports | pytest-style assertions, CLI, datasets, test runs |
| Multi-turn evaluation | Not its current focus | Conversational and turn-level metrics |
| Audit artifact | Canonical verification report | Metric results, reasons, traces, test runs |
What DeepEval evaluates
DeepEval’s RAG guidance distinguishes generator and retriever components.
Generator-focused metrics include:
- Faithfulness: whether generated claims are supported by retrieved context;
- Answer Relevancy: whether the response addresses the input.
Retriever-focused metrics include:
- Contextual Relevancy: whether retrieved context is relevant;
- Contextual Precision: whether relevant context ranks appropriately;
- Contextual Recall: whether required information was retrieved.
DeepEval also supports G-Eval for custom natural-language criteria, agent metrics, safety metrics, conversational cases, tracing, and broader test orchestration.
What Ethos evaluates
Ethos checks caller-provided citations against a trusted GroundingSource. Its questions are exact:
- Does the source fingerprint match?
- Does the page, element, span, region, table, or cell exist?
- Does the quote or structured value match?
- Does the source expose the required evidence capability?
- Is the citation stale, mismatched, missing, unsupported, or grounded?
Ethos does not assign general answer-quality scores or judge conversational usefulness.
DeepEval Faithfulness versus Ethos grounding
| Scenario | DeepEval Faithfulness | Ethos | Combined diagnosis |
|---|---|---|---|
| Claim follows retrieval context; displayed page is wrong | May pass | Fails locator | Correct semantics, defective citation |
| Citation exists; claim overstates passage | May fail | Passes grounding | Real evidence, unsupported claim |
| Answer uses obsolete retrieved context | May pass against context | Fails fingerprint if pinned | Stale source problem |
| Retrieval omitted exception | May pass on available context | Cannot invent missing evidence | Retrieval recall problem |
| Correct facts, wrong calculation | May vary | Verifies inputs only | Recompute in code |
| Parser lacks tables | Judge may see flattened text | Reports capability limitation | Parsing/evidence fidelity problem |
The tools provide orthogonal evidence.
HallucinationMetric versus FaithfulnessMetric
Current DeepEval documentation advises using its Faithfulness metric for live RAG retrieval_context. The Hallucination metric compares output against curated context treated as reference material and calculates contradiction-oriented results.
This distinction does not make either metric a document-locator verifier. Both operate over context supplied to the test case rather than independently proving the displayed source page or fingerprint.
Where G-Eval fits
G-Eval lets developers define custom semantic criteria in natural language. It can evaluate:
- domain-specific faithfulness;
- completeness;
- tone or professionalism;
- safety criteria;
- relevance;
- synthesis quality.
Do not replace exact Ethos checks with G-Eval. Asking a judge whether a fingerprint “looks fresh” or whether an element ID “probably exists” adds cost and uncertainty to a deterministic proposition.
Use G-Eval after Ethos when a grounded claim needs semantic judgment.
Integrating Ethos as a deterministic metric
A custom DeepEval metric can call Ethos and convert its structured report into a score and reason.
from deepeval.metrics import BaseMetric
from ethos_pdf import EthosCli, proof_summary
class EthosGroundingMetric(BaseMetric):
threshold = 1.0
def __init__(self, source: str, citations: str, binary: str = "ethos"):
self.source = source
self.citations = citations
self.ethos = EthosCli(binary=binary)
self.score = 0.0
self.reason = "Not measured"
self.success = False
def measure(self, test_case):
report = self.ethos.verify(
source=self.source,
citations=self.citations,
fail_on_ungrounded=False,
output_format="json",
timeout=30,
)
summary = proof_summary(report)
self.score = 1.0 if summary["request_certified"] else 0.0
self.success = self.score >= self.threshold
self.reason = f"Ethos proof status: {summary['proof_status']}"
return self.score
async def a_measure(self, test_case):
return self.measure(test_case)
def is_successful(self):
return self.success
@property
def __name__(self):
return "Ethos Grounding"
Pin this adapter to the installed DeepEval and Ethos API versions, validate actual abstract-method requirements, and preserve the canonical Ethos report separately. A score of 1.0 is only citation grounding, not complete answer correctness.
Combined test case design
from deepeval import evaluate
from deepeval.metrics import AnswerRelevancyMetric, FaithfulnessMetric
from deepeval.test_case import LLMTestCase
test_case = LLMTestCase(
input="What was Q3 2025 revenue?",
actual_output="Q3 2025 revenue was $12.4 million.",
retrieval_context=["Revenue grew to $12.4M in Q3 2025."],
)
evaluate(
test_cases=[test_case],
metrics=[
EthosGroundingMetric(
source="annual-report.ethos.json",
citations="citations.json",
),
FaithfulnessMetric(),
AnswerRelevancyMetric(),
],
)
The Ethos metric evaluates source binding. Faithfulness evaluates semantic support against retrieved context. Answer relevance evaluates responsiveness.
CI/CD architecture
Fast deterministic lane
Run Ethos fixtures on every relevant pull request:
- grounded quote;
- wrong page;
- altered quote;
- missing target;
- stale fingerprint;
- capability-blocked table request.
Semantic regression lane
Run DeepEval over representative datasets for faithfulness, relevance, and retrieval metrics. Pin judge configuration and validate thresholds against human labels.
End-to-end release lane
Run the application, capture generated citations, invoke Ethos, compute DeepEval metrics, and apply release policy. Store privacy-safe reports and test-run references.
The RAG citation CI/CD guide provides a full test pyramid.
DeepEval strengths
- Broad metric ecosystem across RAG, agents, conversations, safety, and multimodal applications.
- Custom evaluation through G-Eval, DAG, and self-coded metrics.
- Test-case, dataset, and pytest-oriented workflows.
- Component-level retriever and generator evaluation.
- Multi-turn RAG metrics and tracing integration.
- Score reasoning and debugging for semantic metrics.
Ethos strengths
- Exact source and citation evidence checks.
- Document fingerprint freshness.
- Page, element, span, table-cell, and region locators.
- Explicit capability limitations.
- Local verification without a judge-model call.
- Canonical reports and inspectable evidence artifacts.
- Parser-neutral
GroundingSourceboundary.
Limitations and mitigation
| Tool | Limitation | Mitigation |
|---|---|---|
| Ethos | Not a general semantic evaluator | Use DeepEval or another calibrated judge |
| Ethos | Requires source-aware evidence and citations | Preserve provenance during ingestion |
| Ethos | Narrow current parser and adapter boundary | Bring your own parser through GroundingSource |
| DeepEval | Most predefined metrics depend on LLM judges | Calibrate and version judges and rubrics |
| DeepEval | Default metrics do not prove exact source locators | Add Ethos deterministic metric |
| DeepEval | Metric scores can hide source staleness | Add fingerprints and source governance |
Privacy, cost, and reproducibility
Ethos exact checks can run locally, avoiding judge tokens for source identity and evidence matching. DeepEval metrics may call configured judge models, creating cost, latency, privacy, and model-version considerations.
Run deterministic checks first. Send bounded verified evidence to semantic evaluation, use approved model providers or local judges, and avoid sending entire confidential documents when claim-level evidence is sufficient.
What neither replaces
Neither tool replaces:
- source authority and access governance;
- parser security isolation;
- complete claim extraction;
- deterministic arithmetic;
- domain-expert review for high-stakes synthesis;
- production monitoring and incident response.
Definitive verdict
Ethos vs DeepEval is a layer comparison, not a universal product contest. Ethos proves source-bound citation properties. DeepEval evaluates semantic, retrieval, conversational, agent, and custom quality criteria and orchestrates tests.
Use DocuShell Parse PDF for source-aware evidence, Ethos as a deterministic custom metric or assertion, DeepEval for broader evaluation, the Ethos release-gate guide for final policy, and the DocuShell hallucination index for wider model-risk context.
Primary keyword: Ethos vs DeepEval
Optimized meta title: Ethos vs DeepEval for RAG Testing
Optimized meta description: Compare Ethos citation grounding with DeepEval RAG metrics, G-Eval, pytest workflows, and LLM-as-a-judge evaluation.
Proposed URL slug: ethos-vs-deepeval-deterministic-evidence-vs-llm-evaluation
Frequently Asked Questions
Free Tool
Hallucination Index
Compare model factuality signals and estimate workflow hallucination risk.
Try Hallucination IndexDocuShell Team
The DocuShell editorial group writes and maintains guides for everyday PDF workflows, with updates made when tool behavior or documented limits change. See our editorial standards for the process behind each article.
Focus: DeepEval integration, RAG testing, LLM-as-a-judge metrics, and deterministic document evidence
Questions or feedback? Get in touch.



