What do I need before installing?

Apache JMeter 5.6.3+ on Java 17+ is required. The plugin runs inside JMeter, so you need a JMeter installation first.

How do I configure an LLM provider?

Append jmeter-ai-quickstart.properties to JMeter's bin/user.properties so existing settings are preserved. Uncomment one provider and add its key, then restart JMeter and pick a model from the dropdown. Ollama and Apple on-device need no key.

⚡ Quickstart

Install JMeter.AI in 5 minutes

Q: How do I install Feather Wand for JMeter?

The easiest way is the JMeter Plugins Manager: Options → Plugins Manager → Available Plugins → search "Feather Wand" → Apply Changes and Restart JMeter. For CI, use the Plugins Manager CLI: bin/PluginsManagerCMD.sh install feather-wand-jmeter-ai-agent. Append jmeter-ai-quickstart.properties to user.properties so existing settings are preserved, then uncomment one provider and add its key. Ollama and Apple on-device need no key.

Feather Wand is an AI agent that lives inside Apache JMeter. Everything below uses the JMeter Plugins Manager, the same install path used by JMeter.AI - Performance Intelligence Suite.

Install Apache JMeter 5.6.3+ on Java 17+ from the official download page if you don't have it yet.
Pick one of the three install methods below.
Append jmeter-ai-quickstart.properties to JMeter's bin/user.properties, preserving any existing settings.
Uncomment one provider and add its key, then restart JMeter. Ollama and Apple on-device need no key.
Open the Feather Wand chat and pick a model from the dropdown.

Install methods

Plugins Manager

The recommended way: install straight from the JMeter Plugins Manager UI.

Open Plugins Manager

# JMeter → Options → Plugins Manager → Available Plugins

Search & install

# Search "Feather Wand" → Apply Changes and Restart JMeter

Configure your AI provider

# Linux / macOS: append quick-start settings and preserve existing properties
{ echo; curl -fsSL https://raw.githubusercontent.com/QAInsights/jmeter-ai/main/jmeter-ai-quickstart.properties; } >> "$JMETER_HOME/bin/user.properties"

# Windows PowerShell
Add-Content "$env:JMETER_HOME\bin\user.properties" ""
(Invoke-WebRequest https://raw.githubusercontent.com/QAInsights/jmeter-ai/main/jmeter-ai-quickstart.properties -UseBasicParsing).Content | Add-Content "$env:JMETER_HOME\bin\user.properties"

# Uncomment one provider and add its key (Ollama and Apple on-device need none), then restart JMeter

CLI

Install via the JMeter Plugins Manager command line (headless & CI friendly).

Linux / macOS

bin/PluginsManagerCMD.sh install feather-wand-jmeter-ai-agent

Windows

bin\PluginsManagerCMD.bat install feather-wand-jmeter-ai-agent

Configure your AI provider

# Linux / macOS: append quick-start settings and preserve existing properties
{ echo; curl -fsSL https://raw.githubusercontent.com/QAInsights/jmeter-ai/main/jmeter-ai-quickstart.properties; } >> "$JMETER_HOME/bin/user.properties"

# Windows PowerShell
Add-Content "$env:JMETER_HOME\bin\user.properties" ""
(Invoke-WebRequest https://raw.githubusercontent.com/QAInsights/jmeter-ai/main/jmeter-ai-quickstart.properties -UseBasicParsing).Content | Add-Content "$env:JMETER_HOME\bin\user.properties"

# Uncomment one provider and add its key (Ollama and Apple on-device need none), then restart JMeter

Direct JAR

Drop the latest release JAR into JMeter's lib/ext directory.

Download the latest release

# Grab the latest JAR from GitHub Releases
# https://github.com/QAInsights/jmeter-ai/releases

Copy into JMeter & restart

cp <downloaded>.jar $JMETER_HOME/lib/ext/
$JMETER_HOME/bin/jmeter

Configure your AI provider

# Linux / macOS: append quick-start settings and preserve existing properties
{ echo; curl -fsSL https://raw.githubusercontent.com/QAInsights/jmeter-ai/main/jmeter-ai-quickstart.properties; } >> "$JMETER_HOME/bin/user.properties"

# Windows PowerShell
Add-Content "$env:JMETER_HOME\bin\user.properties" ""
(Invoke-WebRequest https://raw.githubusercontent.com/QAInsights/jmeter-ai/main/jmeter-ai-quickstart.properties -UseBasicParsing).Content | Add-Content "$env:JMETER_HOME\bin\user.properties"

# Uncomment one provider and add its key (Ollama and Apple on-device need none), then restart JMeter

First prompt to try

Open Feather Wand from the JMeter Tools menu, pick your model, and ask something like:

"Generate a JMX test plan with 50 virtual users, a ramp-up of 30 seconds, and assertions on the response time."

Agent Mode is on by default, so the AI edits the plan directly. Switch to Chat under the message box any time you just want answers.