⚡ Quickstart

Install JMeter.AI in 5 minutes

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.

  1. Install Apache JMeter 5.6.3+ from the official download page if you don't have it yet.
  2. Pick one of the three install methods below.
  3. Copy jmeter-ai-sample.properties into JMeter's bin/user.properties.
  4. Add your LLM API key (or point at a local Ollama) and restart JMeter.
  5. 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
# Copy the sample config into JMeter's user.properties
cp jmeter-ai-sample.properties $JMETER_HOME/bin/user.properties

# Add your LLM API key (or point at a local Ollama)
anthropic.api.key=sk-ant-...

# Restart JMeter and pick a model from the dropdown

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
# Copy the sample config into JMeter's user.properties
cp jmeter-ai-sample.properties $JMETER_HOME/bin/user.properties

# Add your LLM API key (or point at a local Ollama)
anthropic.api.key=sk-ant-...

# Restart JMeter and pick a model from the dropdown

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
# Copy the sample config into JMeter's user.properties
cp jmeter-ai-sample.properties $JMETER_HOME/bin/user.properties

# Add your LLM API key (or point at a local Ollama)
anthropic.api.key=sk-ant-...

# Restart JMeter and pick a model from the dropdown

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

Want to go deeper? Enable Agent Mode with jmeter.ai.agent.enabled=true in user.properties and let the AI edit the plan directly.