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