Installation and setup
Installing promptfoo is one npm command that puts a single promptfoo executable on your PATH, pinned to version 0.124.1.
Last updated: 15 Oct, 2026 · Promptfoo 0.124.1
Promptfoo is a Node command-line tool, so it installs with npm rather than pip. You can install it once globally, or run it without installing through npx. Pin the version so a later release cannot change what the commands print under you.
Installing with npm
Syntax: the version after the @ pins the release; leave it off and you get the latest.
npm install -g promptfoo@0.124.1No API key is set up here, and none is needed anywhere in this course. The provider under test is a built-in or a Python file you write, and the model judge later is a script promptfoo calls.
Checking the version
One command confirms the executable is on your PATH and reports the exact release. It should print the pinned version.
promptfoo --version0.124.1
The Node floor
Promptfoo needs Node 22.22 or newer. On an older Node it refuses before it reads your config or runs anything, prints the version it found against the one it needs, and exits. This lab runs Node 24, so you will not meet this message, but it is worth knowing the shape of it.
promptfoo requires a supported Node.js runtime.
Detected: v22.12.0
Required: >=22.22.0
Install a supported Node.js version and try again.The fix is to upgrade Node, not to change any promptfoo setting; there is no flag that lowers the floor.
Related
- Previous: Promptfoo overview
- Next: Checking a support bot's answers in Python
- Reference: Promptfoo installation docs
- Run
promptfoo --versionand confirm it prints0.124.1. - Install without the
@0.124.1pin in a scratch folder and read which version you get. - Run
promptfoo --helpand read the list of subcommands;evalis the one this part uses.
Little by little, you're building something great.