用于评估提示词和对 LLM 应用做红队测试的命令行工具与库,支持声明式配置和 CI/CD 集成。
EleutherAI/lm-evaluation-harness
统一的语言模型少样本评测框架,覆盖大量标准学术基准测试。
- Star
- 14,275
- Fork
- 3,698
- 未关闭 Issue
- 1,212
- 最近提交
- 上个月
这是什么?
lm-evaluation-harness 是一个用于评测生成式语言模型的框架,内置 60 多个标准学术基准,包含数百个子任务和变体。它使用公开的提示词模板,便于不同论文之间的结果对比。
框架支持多种模型后端,包括 Hugging Face transformers(可加载 PEFT 适配器并进行量化)、vLLM、SGLang、由 llama.cpp 提供服务的 GGUF 模型、ONNX Runtime、NVIDIA NeMo、Megatron-LM,以及 OpenAI、Anthropic、TextSynth 等商业 API。多卡场景可通过 accelerate 的数据并行、模型切分和张量并行实现。任务和提示词以 YAML 定义,命令行支持子命令和配置文件。
它也是 Hugging Face Open LLM Leaderboard 背后的评测后端。用户可以添加自定义任务、提示词和指标,新版本还支持通过插件从外部包注册后端、过滤器和指标。
核心功能
- 01覆盖 60 多个标准学术大模型基准,包含数百个子任务。
- 02支持 Hugging Face transformers、vLLM、SGLang、llama.cpp、ONNX Runtime 和 NeMo 等后端。
- 03可评测 OpenAI、Anthropic、TextSynth 等商业 API 提供的模型。
- 04通过数据并行、模型切分和张量并行实现多卡评测。
- 05任务和提示词以 YAML 定义,可通过命令行或 Python API 运行。
- 06支持通过配置或插件添加自定义任务、指标和模型后端。
适用场景
- 用标准学术任务评测新训练或微调的模型。
- 使用论文中相同的提示词复现已发表的评测结果。
- 在统一流程中比较量化、LoRA 适配或自部署模型与商业 API 的表现。
- 模型检查点更新时,在 CI 中运行回归评测。
快速上手
- 1
克隆代码仓库
git clone --depth 1 https://github.com/EleutherAI/lm-evaluation-harness - 2
进入项目目录并以可编辑模式安装
cd lm-evaluation-harness && pip install -e . - 3
安装 HuggingFace 模型后端
pip install "lm_eval[hf]" - 4
在 hellaswag 任务上评测 HuggingFace 模型
lm_eval --model hf --model_args pretrained=EleutherAI/gpt-j-6B --tasks hellaswag --device cuda:0 --batch_size 8
使用前须知
- HuggingFace 或 vLLM 等模型后端需要单独安装,示例运行假定使用支持 CUDA 的 GPU。
标签
常见问题
- lm-evaluation-harness 是什么?
- 统一的语言模型少样本评测框架,覆盖大量标准学术基准测试。 lm-evaluation-harness 是一个用于评测生成式语言模型的框架,内置 60 多个标准学术基准,包含数百个子任务和变体。它使用公开的提示词模板,便于不同论文之间的结果对比。
- lm-evaluation-harness 可以免费使用吗?用的什么许可证?
- lm-evaluation-harness 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- lm-evaluation-harness 还在维护吗?
- 半年内有更新。lm-evaluation-harness 最近一次提交是在 2026年9月14日。
- lm-evaluation-harness 适合用来做什么?
- 用标准学术任务评测新训练或微调的模型。 使用论文中相同的提示词复现已发表的评测结果。 在统一流程中比较量化、LoRA 适配或自部署模型与商业 API 的表现。 模型检查点更新时,在 CI 中运行回归评测。
- lm-evaluation-harness 怎么安装和运行?
- 克隆代码仓库: git clone --depth 1 https://github.com/EleutherAI/lm-evaluation-harness 进入项目目录并以可编辑模式安装: cd lm-evaluation-harness && pip install -e . 安装 HuggingFace 模型后端: pip install "lm_eval[hf]" 在 hellaswag 任务上评测 HuggingFace 模型: lm_eval --model hf --model_args pretrained=EleutherAI/gpt-j-6B --tasks hellaswag --device cuda:0 --batch_size 8
- 在哪里获取 lm-evaluation-harness?
- 源代码和安装说明在 GitHub 上:https://github.com/EleutherAI/lm-evaluation-harness
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
开源 Python LLM 评测框架,可像 Pytest 一样对 LLM 应用做单元测试,内置 RAG、Agent、多轮对话等指标。
基于 Rust 的高性能分词库,提供 Python 和 Node.js 绑定,用于 NLP 与大语言模型流程。
用于评测语言模型能否通过生成补丁解决真实 GitHub Issue 的基准与 Docker 评测工具。
一个开源医疗视觉-语言模型,可处理医学文本、2D图像、3D体数据和手术视频,训练数据全部公开。
基于 GRPO 的 Python 强化学习框架,让多步骤 LLM 智能体从自身经验中学习。