Promptfoopromptfoo 0.124.1 · Node 24 · Python 3
Dashboard
0%

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.1

No 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.

Examplepromptfoo reports its pinned version
promptfoo --version

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.

text
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.

Try it yourself
  • Run promptfoo --version and confirm it prints 0.124.1.
  • Install without the @0.124.1 pin in a scratch folder and read which version you get.
  • Run promptfoo --help and read the list of subcommands; eval is the one this part uses.

Little by little, you're building something great.