llm-autoeval
llm-autoeval 是一款专为简化大语言模型(LLM)评估流程而设计的开源工具,让用户能在 Google Colab 环境中轻松完成模型性能测试。它主要解决了传统模型评估配置复杂、环境搭建耗时以及硬件门槛高的问题。用户只需输入模型名称、选择基准测试集并指定云端 GPU 配置,点击运行即可自动完成从环境部署到结果生成的全过程。
这款工具非常适合 AI 开发者、研究人员以及希望快速验证模型效果的爱好者使用。其核心亮点在于高度自动化:底层集成 RunPod 云服务自动调配算力,支持 Nous、LightEval 及 Open LLM 等多种主流评测基准,并能将评估报告自动生成摘要上传至 GitHub Gist,便于分享与归档。此外,它还允许用户灵活调整 GPU 型号、磁盘大小等参数,以平衡成本与性能。作为个人主导的早期项目,llm-autoeval 以极简的操作降低了专业评测的技术门槛,是进行模型对比和迭代开发的得力助手。
使用场景
某独立开发者正在微调一个垂直领域的医疗问答模型,急需在发布前验证其性能是否优于基线模型。
没有 llm-autoeval 时
- 环境配置繁琐:需在本地或云端手动安装复杂的依赖库(如 vllm、lighteval),常因版本冲突耗费数小时调试。
- 硬件门槛高:运行 MMLU 或 GSM8K 等大型基准测试需要高性能 GPU,个人开发者难以承担长期占用昂贵算力的成本。
- 流程割裂低效:从启动测试、监控运行到整理分数,需人工拼接多个脚本,结果分散在不同日志文件中难以对比。
- 分享协作困难:生成的评估报告格式不统一,无法一键生成可共享的链接,团队讨论时只能截图或复制粘贴文本。
使用 llm-autoeval 后
- 一键自动部署:只需在 Colab 中输入模型 ID 和基准名称,llm-autoeval 自动调用 RunPod 配置好所有环境与依赖,即刻开始测试。
- 弹性算力支持:按需选择 RTX 3090 等高性能云 GPU,测试结束后自动释放资源,大幅降低单次评估的金钱与时间成本。
- 全流程自动化:自动执行测试并生成结构化摘要,无需人工干预即可得到清晰的准确率与损耗数据。
- 即时共享结果:测试完成后自动将结果上传至 GitHub Gist,生成永久链接,方便团队成员直接查看和对比不同版本的模型表现。
llm-autoeval 将原本耗时数天的复杂评估工作压缩为几分钟的自动化流程,让开发者能专注于模型优化而非基础设施搭建。
运行环境要求
- Linux (通过 RunPod 云环境)
- 必需
- 推荐使用 NVIDIA RTX 3090 或更高型号(如用于 Open LLM 基准测试)
- 支持多 GPU 配置以扩展显存
- 具体 CUDA 版本未说明,由云镜像决定
未说明(取决于所选 GPU 的云实例配置)

快速开始
🔍 概述
LLM AutoEval 通过一个便捷的 Colab 笔记本 简化了 LLM 的评估流程。你只需指定模型名称、基准测试、GPU 类型,然后点击运行即可!
主要特性
- 使用 RunPod 实现自动化设置和执行。
- 可自定义的评估参数,满足个性化的基准测试需求。
- 自动生成总结并上传至 GitHub Gist,便于分享和参考。
注:该项目尚处于早期阶段,主要面向个人使用。请谨慎使用,并欢迎贡献代码。
⚡ 快速入门
评估
MODEL_ID: 输入 Hugging Face 上的模型 ID。BENCHMARK:nous: 包含 AGIEval、GPT4ALL、TruthfulQA 和 Bigbench 等任务(由 Teknium 和 NousResearch 推广)。推荐使用此选项。lighteval: 这是 Hugging Face 推出的新库,允许你按照 README 中的说明指定任务。请参阅推荐任务列表,了解可使用的任务(如 HELM、PIQA、GSM8K、MATH 等)。openllm: 包括 ARC、HellaSwag、MMLU、Winogrande、GSM8K 和 TruthfulQA 等任务(类似于 Open LLM Leaderboard)。该套件采用 vllm 实现以提升速度(请注意,结果可能与未使用 vllm 时略有不同)。目前 MMLU 尚未包含,因 vllm 存在问题。
LIGHTEVAL_TASK: 可根据 README 或推荐任务列表选择一项或多项任务。
云 GPU
GPU: 选择用于评估的 GPU(价格见这里)。建议使用高性能 GPU(如 RTX 3090 或更高),尤其是针对 Open LLM 基准测试套件。GPU 数量: 显而易见(如果需要更多显存,使用多个 GPU 比单个大显存 GPU 更经济)。CONTAINER_DISK: 容器磁盘大小,单位为 GB。CLOUD_TYPE: RunPod 提供社区云(更便宜)和安全云(更可靠)两种选择。REPO: 如果你对本仓库进行了 fork,可以在此处指定其 URL(镜像仅运行runpod.sh)。TRUST_REMOTE_CODE: 像 Phi 这样的模型需要此标志才能运行。PRIVATE_GIST: (开发中)将结果 Gist 设置为私有(true)或公开(false)。DEBUG: 作业结束后不会销毁容器(不推荐)。
Tokens
Tokens 使用 Colab 的 Secrets 功能。创建两个名为 “runpod” 和 “github” 的密钥,并添加相应的 token,获取方式如下:
RUNPOD_TOKEN: 如果你还没有账户,请考虑使用我的推荐链接。你可以在 这里 的“API 密钥”部分创建 token(读写权限)。此外,还需向账户充值以启动容器。GITHUB_TOKEN: 你可以在 这里 创建 token(读写权限,也可限制为仅访问 gist)。HF_TOKEN: 可选。如果你有 Hugging Face 账户,可在 这里 找到你的 token。
📊 基准测试套件
Nous
你可以将自己的结果与以下内容进行比较:
- YALL - 另一个 LLM 排行榜,这是我基于 LLM AutoEval 生成的 Gist 制作的排行榜。
- 像 OpenHermes-2.5-Mistral-7B、Nous-Hermes-2-SOLAR-10.7B 或 Nous-Hermes-2-Yi-34B 等模型。
- Teknium 将他的评估结果存储在他的 LLM-Benchmark-Logs 中。
Lighteval
你可以根据所选任务逐项比较自己的结果。
Open LLM
你可以将自己的结果与 Open LLM Leaderboard 上列出的结果进行比较。
🏆 排行榜
我利用 LLM AutoEval 生成的总结,创建了 YALL - 另一个 LLM 排行榜,并绘制了如下图表:

如果你有兴趣一键用自己的 Gist 创建排行榜,请告诉我。这可以轻松转化为一个小笔记本,为你打造这样一个空间。
🛠️ 故障排除
- “错误:文件不存在”: 该任务未生成用于解析总结的 JSON 文件。请启用调试模式并重新运行评估,以检查日志中的问题。
- “700 Killed” 错误: 硬件性能不足以完成评估。例如,在 RTX 3070 上运行 Open LLM 基准测试套件时可能会出现此情况。
- CUDA 驱动程序过时: 这很不幸。在这种情况下,你需要启动一个新的容器。
- “triu_tril_cuda_template” 不支持 ‘BFloat16’: 请按照 此问题 中的说明切换镜像。
致谢
特别感谢 burtenshaw 集成 lighteval,感谢 EleutherAI 提供的 lm-evaluation-harness,感谢 dmahan93 基于 lm-evaluation-harness 分支新增 agieval 的工作,感谢 Hugging Face 提供的 lighteval 库,感谢 NousResearch 和 Teknium 构建的 Nous 基准测试套件,以及 vllm 带来的额外推理速度提升。
常见问题
相似工具推荐
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上
NextChat
NextChat 是一款轻量且极速的 AI 助手,旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性,以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发,NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。 这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言,它也提供了便捷的自托管方案,支持一键部署到 Vercel 或 Zeabur 等平台。 NextChat 的核心亮点在于其广泛的模型兼容性,原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型,让用户在一个界面即可自由切换不同 AI 能力。此外,它还率先支持 MCP(Model Context Protocol)协议,增强了上下文处理能力。针对企业用户,NextChat 提供专业版解决方案,具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能,满足公司对数据隐私和个性化管理的高标准要求。
ML-For-Beginners
ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程,旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周,包含 26 节精炼课程和 52 道配套测验,内容涵盖从基础概念到实际应用的完整流程,有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员,还是对人工智能充满好奇的普通爱好者,都能从中受益。课程不仅提供了清晰的理论讲解,还强调动手实践,让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持,通过自动化机制提供了包括简体中文在内的 50 多种语言版本,极大地降低了全球不同背景用户的学习门槛。此外,项目采用开源协作模式,社区活跃且内容持续更新,确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路,ML-For-Beginners 将是理想的起点。
ragflow
RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体(Agent)能力相结合,不仅支持从各类文档中高效提取知识,还能让模型基于这些知识进行逻辑推理和任务执行。 在大模型应用中,幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构(如表格、图表及混合排版),显著提升了信息检索的准确度,从而有效减少模型“胡编乱造”的现象,确保回答既有据可依又具备时效性。其内置的智能体机制更进一步,使系统不仅能回答问题,还能自主规划步骤解决复杂问题。 这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统,还是致力于探索大模型在垂直领域落地的创新者,都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口,既降低了非算法背景用户的上手门槛,也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目,它正成为连接通用大模型与行业专有知识之间的重要桥梁。
PaddleOCR
PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来,转换成计算机可读取的结构化数据,让机器真正“看懂”图文内容。 面对海量纸质或电子文档,PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域,它扮演着连接图像与大型语言模型(LLM)的桥梁角色,能将视觉信息直接转化为文本输入,助力智能问答、文档分析等应用场景落地。 PaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显:不仅支持全球 100 多种语言的识别,还能在 Windows、Linux、macOS 等多个系统上运行,并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目,PaddleOCR 既能满足快速集成的需求,也能支撑前沿的视觉语言研究,是处理文字识别任务的理想选择。
awesome-machine-learning
awesome-machine-learning 是一份精心整理的机器学习资源清单,汇集了全球优秀的机器学习框架、库和软件工具。面对机器学习领域技术迭代快、资源分散且难以甄选的痛点,这份清单按编程语言(如 Python、C++、Go 等)和应用场景(如计算机视觉、自然语言处理、深度学习等)进行了系统化分类,帮助使用者快速定位高质量项目。 它特别适合开发者、数据科学家及研究人员使用。无论是初学者寻找入门库,还是资深工程师对比不同语言的技术选型,都能从中获得极具价值的参考。此外,清单还延伸提供了免费书籍、在线课程、行业会议、技术博客及线下聚会等丰富资源,构建了从学习到实践的全链路支持体系。 其独特亮点在于严格的维护标准:明确标记已停止维护或长期未更新的项目,确保推荐内容的时效性与可靠性。作为机器学习领域的“导航图”,awesome-machine-learning 以开源协作的方式持续更新,旨在降低技术探索门槛,让每一位从业者都能高效地站在巨人的肩膀上创新。