LibreAI / AI Agents / promptfoo
// agents · promptfoo/promptfoo

promptfoo

Test prompts, agents and RAGs — LLM evals, red teaming and model comparisons from the CLI

★ 25.8k stars⑂ 2.5k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

promptfoo is an open-source ai agents project by promptfoo (promptfoo/promptfoo on GitHub). It has 25,815 GitHub stars and 2,452 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
25,815
Forks
2,452
License
MIT
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with promptfoo and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Prompt and model comparison

Run the same test set across models and prompts to compare quality side by side.

Red teaming and vulnerability scanning

Automated probes for prompt injection, jailbreaks and other AI security issues.

RAG and agent evaluation

Evaluate retrieval pipelines and agent behaviors, not just single prompts.

Declarative configs

Tests live in simple config files that version well in git.

CI/CD integration

Designed to run in pipelines so regressions block deploys.

Local-first CLI

Runs from your terminal with npx — no platform account required to start.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the Promptfoo source and examples.

    git clone https://github.com/promptfoo/promptfoo.git
    cd promptfoo
  2. Install the CLI

    Install globally from npm (brew and pip installs are also documented), or skip installation with npx.

    npm install -g promptfoo
  3. Run your first eval

    Initialize an example config, add your model key, and run the evaluation.

    promptfoo init
    promptfoo eval
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains promptfoo?

promptfoo is maintained by the promptfoo organization/account on GitHub, together with open-source contributors, in the public repository promptfoo/promptfoo.

Is promptfoo free to use?

Yes — the code is open source under the MIT license. You can use, modify and redistribute it under that license's terms.

Does promptfoo need a paid API key?

Promptfoo is free and MIT-licensed; evaluations call the models you test, so you need API keys for those providers (local/open models are also supported).

How does promptfoo compare to LangSmith / Braintrust?

Those are hosted evaluation platforms; Promptfoo is a local-first, config-in-git CLI with strong red-teaming — lighter to adopt, and your tests live with your code.

How do I get started with promptfoo?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

AI Agents

bisheng

Enterprise LLM app platform: GenAI workflows, RAG, agents, model management, evaluation, fine-tuning.

★ 12.0k starsApache-2.0
View guide →
AI Agents

pi

A TypeScript toolkit for building agents: unified LLM API, loop, TUI, and CLI.

★ 113.3k starsMIT
View guide →
AI Agents

botpress

Open-source hub of integrations, SDK and CLI for building and deploying GPT/LLM chatbots and agents.

★ 14.9k starsMIT
View guide →
Agents

deepteam

Open-source red-teaming framework that stress-tests LLMs and AI agents.

★ 3.0k starsApache-2.0
View guide →
AI Agents

MobileBuildMCP

An MCP server and CLI that lets AI agents build, test and run iOS and macOS projects.

★ 6.5k starsMIT
View guide →
AI Agents

agentdojo

Test your agents against prompt-injection attacks.

★ 897 starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if promptfoo is not the right fit.

Get promptfoo

Free and open — grab the source, star the repo, and start creating.