Beta · Apache-2.0 · written in Go

Load that tells you
the truth about your service.

resonate drives configurable load against HTTP, HTTP/3, WebSocket, Server-Sent Events, gRPC and MCP servers. One binary for quick one-liners, reusable YAML scenarios, or embed the same engine as a Go library.

resonate hit http://localhost:8080/api/orders -H 'Accept: application/json' --expect-status 200 --rate 50 --duration 30s
6protocols, one engine
1static binary, zero runtime deps
3reports every run: HTML, JSON, JSONL
CIassertions that fail the build

Built for engineers who measure things

Everything you need to go from "does it work?" to "does it hold up?" without a pile of tooling.

Open & closed models

Fixed workers for closed-loop tests, or target a request rate and let concurrency grow with --max-workers to avoid coordinated omission.

Templated requests

URLs, headers, queries and bodies accept {{ }} expressions re-rendered per request: sequence numbers, UUIDs, env vars, feeders.

Multi-step scenarios

Chain requests, extract values from JSON, YAML or XML responses, and reuse them downstream. Define it all in plain YAML.

Assertions & CI gating

--assert 'latency_p95<=500ms' returns a non-zero exit code. resonate compare flags regressions between two reports.

Reports out of the box

A self-contained report.html, a machine-readable report.json, and per-request results.jsonl on every run.

Multiple scenarios

Run several workloads at once, each with its own load profile, plus shared suite defaults and per-step metrics.

Feeders & payloads

Drive requests from files, inline rows or a Kafka topic. Send JSON, protobuf or compressed (gzip, deflate, br, zstd) bodies.

Native MCP load testing

Load-test the tool servers AI agents call. One MCP session per virtual user, every tool call its own step, and isError results counted as failures.

Modern transport

HTTP/1.1, HTTP/2 (including h2c), HTTP/3 over QUIC, mTLS, private CAs, and keep-alive control.

One tool, every protocol

Stop juggling a different load tool for each transport.

HTTP1.1 · 2 · h2c
HTTP/3QUIC over UDP
WebSocketsend / receive steps
SSEServer-Sent Events
gRPCunary & streaming
MCPnative · streamable HTTP

Start with a flag. Grow into a scenario.

Quick runs use resonate hit. When a test deserves to live in version control, describe it in YAML and run it anywhere with resonate run.

  • JSON Schema via resonate schema for editor autocomplete
  • Feeders for realistic, varied data
  • Per-request status, header and body checks
  • Treat scenario files as trusted input, like shell scripts
# POST with a templated body, gate on p95 in CI
resonate hit https://api.example.com/orders \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"id": {{.Seq}}, "tok": "{{uuid}}"}' \
  --rate 200 --workers 50 --duration 1m \
  --expect-status 200,201 \
  --assert 'success_rate>=0.99' \
  --assert 'latency_p95<=500ms'

A real report, generated by resonate

Every run writes a self-contained report.html and a machine-readable report.json. This one is unedited output from a 30s, 60 iterations/s checkout flow (browse → cart → checkout). Excerpt below; open the full report to see the rest.

cat > checkout.yaml << 'EOF' protocol: http load: duration: 30s rate: 60 workers: 40 http: timeout: 5s base_url: http://localhost:18080 flow: - name: browse method: GET url: /products - name: add-to-cart method: GET url: /cart - name: checkout method: GET url: /checkout EOF resonate run checkout.yaml
report.htmlOpen full report ↗
Excerpt of a resonate report: summary cards for 5,523 requests at 98.8% success and 123.5 ms p95, requests-over-time and latency-over-time charts, and a per-step table for browse, add-to-cart and checkout.

Install in seconds

Install with Homebrew, grab a prebuilt binary, or build from source.

1 · Install

brew install jecklgamis/tap/resonate

Or build from source with go build -o bin/resonate ./cmd/resonate, or download a binary from the releases page.

2 · Fire a test

resonate hit https://example.com --duration 2s

A stdout summary plus report.html, report.json and results.jsonl.

3 · Use as a library

go get github.com/jecklgamis/resonate

Same engine, fluent Scenario DSL.

Heads up: resonate is in beta. The scenario YAML schema, report formats and exit codes are stable and versioned; new flags and features may still land, and the Go library API may change before 1.0.

Find your limits before your users do.

For enquiries, contact us at [email protected]