项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 26936
使用教程
环境要求
- Node.js >= 22.22.0(推荐 Node.js 24 LTS)
- 可用的 LLM 提供商 API Key(如 OpenAI)
- 终端可执行 npm / npx 命令
安装与启动步骤
-
1安装 promptfoo
全局安装 CLI,安装后即可在任意目录使用 promptfoo 命令。
npm install -g promptfoo -
2初始化示例
用内置的 getting-started 示例生成配置文件和目录,便于快速上手。
promptfoo init --example getting-started -
3设置 API Key
大多数 LLM 提供商需要 API Key,通过环境变量传入,注意换成你自己的真实 Key。
export OPENAI_API_KEY=sk-abc123 -
4进入示例目录
切换到 init 生成的 getting-started 目录,后续命令都在此目录执行。
cd getting-started -
5运行评估
按 YAML 配置执行测试用例与断言,命令行会输出各提示词/模型的结果对比。
promptfoo eval -
6查看结果
启动 Web 界面浏览评估结果与性能对比,按终端提示的本地地址在浏览器打开。
promptfoo view
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | LLM 提供商的 API 密钥,供 eval 调用模型时鉴权使用 | sk-abc123 |
如何确认成功
promptfoo eval 正常输出评估结果表格,promptfoo view 能打开 Web 界面查看对比结果。
常见问题
Q:没有安装 Node.js 怎么办?
A:promptfoo 也支持 brew install promptfoo 或 pip install promptfoo;此外可用 npx promptfoo@latest 在免安装的情况下运行任意命令。
Q:Node.js 版本有要求吗?
A:README 要求 Node.js >= 22.22.0,推荐使用 Node.js 24 LTS,版本过低可能导致安装或运行失败。
Q:不想全局安装可以吗?
A:可以,使用 npx promptfoo@latest 直接运行命令,无需 npm install -g。
Q:必须配置 API Key 吗?
A:大多数 LLM 提供商需要 API Key,README 建议将其设置为环境变量后再执行 eval。
注意事项
- promptfoo 已加入 OpenAI,但仍保持开源并采用 MIT 许可证。
- 除评估(eval)外,还提供红队测试/漏洞扫描能力,可参考官方 Red Teaming 文档。
核心亮点
- 声明式配置,几分钟内创建测试集,支持批量对比模型和提示词
- 内置红队测试和漏洞扫描,主动发现提示注入和越狱风险
- 深度集成 CI/CD,可自动拦截模型性能回退
不足之处
- 高级红队功能依赖外部 API,可能产生额外成本
- 文档/社区待观察
适用场景
- LLM 应用开发中对比提示词和模型选型
- CI/CD 中自动回归测试,防止性能下降
- 安全团队对 AI 应用进行红队安全审计
替代项目
DeepEval、LangSmith、Ragas
上一篇:awesome-MLSecOps
下一篇:opik
同类项目推荐
Video-MME-v2
开源
评测视频大模型,从看懂片段到理解长视频全场景。
Video-MME-v2: Towards the Next Stage in Benchmarks for Comprehensive Video Understan···
sample-agent-cost-bench
开源
横向评测编程代理的成本、质量与耗时
Benchmark framework that measures cost, quality, and duration of coding agents acros···
Rules.txt
开源
用指令集撬开AI黑盒,审计推理与偏见
LLM alignment jailbreak; a set of instructions for auditing their internal reasoning···
context-bombs
开源
用现成的攻击字符串,测出你的 AI 系统抗不抗揍。
Context bomb strings
NOIR
开源
用 adb 给手机做隐私体检,看清 App 上报了什么
手机隐私审计:用 adb 扫出 Android 应用的权限、上报端点与数据流向,并给出可回滚的处置···
ClawProBench
开源
在真实 OpenClaw 里反复跑 Agent,用确定性打分比出谁更稳
ClawProBench is a live-first benchmark harness for evaluating LLM agents in the Op···
awesome-llm-interpretability
开源
一页看全大模型可解释性论文与工具
A curated list of Large Language Model (LLM) Interpretability resources.
Jailbreak-Foundry
开源
把越狱论文变成可跑的攻击测试,实时更新基准
A system that turns jailbreak papers into runnable attacks and benchmarks — live, a···
ablation
开源
用 LLM 智能体自动读汇编、追调用链,加速二进制逆向
Ablation is an AI-assisted reverse engineering (AIARE) framework
