gbrain-evals

给 AI Agent 建可复现的自动评分,改提示词不怕退化

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 评测安全 🍴 复刻 83 🐛 待处理 29 👀 关注 4
GitHub ↗
GitHub 星标 ★ 450
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,免费使用

项目预览

gbrain-evals 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类评测安全
开发团队garrytan
定价模式🏷️完全免费
价格说明开源项目,免费使用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
GitHub 星标★ 450
上线时间2026-04-22 00:00:00
代码更新2026-11-03
仓库体积1.61 GB
本站数据更新2026-11-04
维护状态活跃
收录时间2026-09-14
浏览次数1

项目介绍

gbrain-evals 是一个用 TypeScript 编写的开源评测框架,面向 AI Agent 与工具调用场景,帮助开发者系统化地衡量模型在真实任务中的表现。它解决的核心问题是:Agent 评测往往依赖零散脚本和人工判断,难以复现和横向对比。项目提供统一的评测用例组织方式、可插拔的执行器与评分器,支持对多轮对话、函数调用、任务完成度等维度进行自动化打分,并输出结构化结果便于回归测试。核心能力包括:定义数据集与期望行为、批量运行不同模型或提示词、对比分数差异、集成到 CI 流程中做持续评测。适合需要为 Agent 建立可量化质量基线的团队,在模型迭代或提示词调整时快速发现退化。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-14 · 当前星标 ★ 450

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 35 分钟 部署方式:本地安装 4 步

环境要求

  • Python 3.10+
  • 模型 API Key

安装与启动步骤

  1. 1拉仓库

    它把数据、对照系统、评分代码与结果都放一起。

    git clone https://github.com/garrytan/gbrain-evals.git
  2. 2装依赖

    评测依赖不多,但要有模型 key。

    pip install -r requirements.txt
  3. 3先跑一遍已有结果

    用自己的机器复现一份,看能否对上它公布的数字。

  4. 4换一个你自己的数据集

    评测套件的价值在于能测你自己的场景。

如何确认成功

同一套数据重跑后分数与公布值差距在可解释范围内,而且换数据集后分数能区分出两个系统的强弱

注意事项

  • 它是评测套件,不是被评测的系统本身。
  • 公布的数字依赖具体模型版本,模型升级后对不上属正常。
  • 评分脚本的判定规则要看清楚,别只看总分。
  • 自建数据集要注意与训练集是否有重叠。

核心亮点

  • 用 TypeScript 编写,类型安全,前端/Node 团队接入成本低
  • 支持可插拔评分器,能自定义任务完成度、工具调用正确性等指标
  • 输出结构化评测结果,便于接入 CI 做回归对比

不足之处

  • 项目处于早期,星标 420,生态和预置评测集较少
  • 文档与社区案例待观察

适用场景

  • 为客服/助手类 Agent 建立回归评测,防止提示词改动导致能力退化
  • 对比多个模型或提示词版本在同一任务集上的得分
  • 在 CI 中自动运行 Agent 评测,作为发布前的质量门禁

替代项目

promptfoo、openai/evals

上一篇:evals-skills

下一篇:evals-skills

同类项目推荐

Awesome-Video-Reasoning 开源

视频生成推理论文一站速查,快速摸清研究地图

This is a collection of recent papers on reasoning in video generation models.

★ 168 2026-10-26
nannyml 开源

模型上线后,用 nannyml 自动盯漂移和性能,提前报警

nannyml: post-deployment data science in python

★ 2161 2026-08-09
llm_chess 开源

让大模型下棋,测出推理和守规则的真实水平

LLM Chess - evaluating Large Language Models' reasoning and instruction-following ab···

★ 137 2026-09-15
MMMU 开源

用大学级多模态考题,测出 AI 的真实专家水平

This repo contains evaluation code for the paper "MMMU: A Massive Multi-discipline M···

★ 600 2026-08-09
deepchecks 开源

给 ML 模型和数据做全面体检,从研究到生产持续验证

Deepchecks: Tests for Continuous Validation of ML Models & Data. Deepchecks is a hol···

★ 4069 2026-08-09
next-evals-oss 开源

给 AI 出 Next.js 考题,看它到底会不会写

Evals for Next.js up to 15.5.6 to test AI model competency at Next.js

★ 328 2026-09-14
AutoControl-Arena 开源

自动给AI找茬,提前暴露危险行为

[ICML 2026] AutoControl Arena: Frontier AI Risk Auto-Discovery Platform

★ 93 2026-08-09
Anti-Autoresearch 开源

一键给自动科研论文做取证,揪出编造与不自洽

Don't trust an autoresearch paper at face value. Reviewer-side integrity forensics (···

★ 175 2026-09-29
Awesome-LM-SSP 开源

一网打尽大模型安全、隐私攻防的精华资料,快速跟上前沿。

A reading list for large models safety, security, and privacy (including Awesome LLM···

★ 2101 2026-08-09