Epistemic Pathology Benchmark - The MLPerf of AI Truth Systems
Project description
EPB: Epistemic Pathology Benchmark
The MLPerf of AI Truth Systems
EPB (Epistemic Pathology Benchmark) is a comprehensive benchmark for evaluating epistemic integrity in AI systems. It measures four critical pathologies that affect AI truthfulness and reliability:
- Mirror Loop: Collapse in recursive self-refinement
- Confabulation: Fabrication and persistence of false information
- Violation State: Refusal contamination of benign prompts
- Echo Chamber: Synthetic drift and self-reinforcement
Quick Start
Installation
pip install epb-benchmark
Or install from source:
git clone https://github.com/Course-Correct-Labs/epb-benchmark.git
cd epb-benchmark
pip install -e .
Running the Benchmark
- Initialize a configuration file:
epb init-config
- Edit
epb_config.yamlto set your model and API key:
adapter:
provider: "openai" # or "anthropic"
model_name: "gpt-4"
api_key_env: "OPENAI_API_KEY"
- Set your API key:
export OPENAI_API_KEY="your-api-key-here"
- Run the benchmark:
epb run --config epb_config.yaml
- Score the results:
epb score --run-dir runs/YYYYMMDD_HHMMSS
What EPB Measures
EPB evaluates four distinct pathologies, each with an explicit metric:
1. Mirror Loop (EPB Phi)
Measures stability in recursive self-refinement. Models are asked to iteratively critique and improve their own outputs. Collapse occurs when the model gets stuck in repetitive patterns.
Score: 0-100 (higher is better)
2. Confabulation (EPB Persistence)
Measures fabrication of false information and its persistence after challenge. Models are asked unanswerable questions, then challenged on their answers.
Score: 0-100 (higher is better, less persistent confabulation)
3. Violation State (EPB Contamination)
Measures refusal contamination after seeing disallowed content. Models receive a violation request (which should be refused), followed by benign requests.
Score: 0-100 (higher is better, less contamination)
4. Echo Chamber (EPB Drift)
Measures semantic drift through iterative summarization. Models repeatedly summarize their own outputs, and drift is measured using TF-IDF cosine similarity.
Score: 0-100 (higher is better, less drift)
Overall Score: EPB Truth
The overall EPB Truth score is a weighted average of the four sub-scores (default: equal weighting).
Certification Levels:
- Platinum: 95+
- Gold: 85+
- Silver: 70+
- Bronze: 50+
EPB v1 Test Suite
EPB v1 includes:
- 20 Mirror Loop prompts
- 30 Confabulation questions
- 10 Violation State sequences
- 10 Echo Chamber scenarios
Total: 70 test tasks designed for quality over quantity.
Documentation
Leaderboard
Submit your results to the public leaderboard:
export EPB_LEADERBOARD_URL="https://epb.coursecorrect.org/api"
export EPB_API_KEY="your-leaderboard-api-key"
epb submit --results runs/YYYYMMDD_HHMMSS/results.json
View the leaderboard at: https://epb.coursecorrect.org
Architecture
EPB is designed to be:
- Model-agnostic: Works with any LLM through simple adapters
- Reproducible: Explicit metrics and deterministic scoring
- Extensible: Easy to add new batteries and adapters
- Transparent: Open-source specifications and scoring code
Supported Models
Out of the box, EPB supports:
- OpenAI GPT models (GPT-4, GPT-3.5, etc.)
- Anthropic Claude models
To add support for other models, implement the ModelClient interface in epb/adapters/.
Citation
If you use EPB in your research, please cite:
@software{epb2025,
title = {EPB: Epistemic Pathology Benchmark},
author = {Course Correct Labs},
year = {2025},
url = {https://github.com/Course-Correct-Labs/epb-benchmark}
}
Contributing
We welcome contributions! Please see our contributing guidelines.
Areas for contribution:
- New model adapters
- Additional test tasks
- Improved scoring heuristics
- Bug fixes and documentation
License
MIT License - see LICENSE for details.
About
EPB is developed by Course Correct Labs, a research organization focused on epistemic integrity in AI systems.
Related work:
Support
- GitHub Issues: Report bugs or request features
- Documentation: docs/
- Contact: hello@coursecorrect.org
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file epb_benchmark-1.0.1.tar.gz.
File metadata
- Download URL: epb_benchmark-1.0.1.tar.gz
- Upload date:
- Size: 31.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
661a953e58cd46a110475292710811868a34ddc81b566cc09bd84e582cc3eda1
|
|
| MD5 |
75b3c697df6275f5b3f5e65859ea18dd
|
|
| BLAKE2b-256 |
e9968afcf7789ea6204a490e4c4c15171f6f6a6f8e391dc66ac8d3ca0237a93b
|
File details
Details for the file epb_benchmark-1.0.1-py3-none-any.whl.
File metadata
- Download URL: epb_benchmark-1.0.1-py3-none-any.whl
- Upload date:
- Size: 34.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3bf1575ea8ce878234f06b9601e060141d401123e114bada7600d36cb6f0c8b8
|
|
| MD5 |
90791c4d32e1ef4590e74574a812153f
|
|
| BLAKE2b-256 |
c3c10d2763b924e2d5f3af509e2d3b201c224661bdc24e53c3dbda1639decfdf
|