# artillery

> Cloud-scale load testing. https://www.artillery.io

Latest version **2.0.34** (published 2026-08-14) · MPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install artillery
pnpm add artillery
yarn add artillery
bun add artillery
```

Provides the command `artillery`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.0.34 |
| Published | 2026-08-14 |
| First published | 2014-09-14 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >= 22.18.0 |
| Dependencies | 93 |
| Unpacked size | 1.5 MB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 9074 |
| Author | Hassy Veldstra |
| Maintainers | hhvhhv, shoreditch-ops |
| Keywords | load testing, stress testing, benchmark, performance, blackbox testing |

## Links

- npm: https://www.npmjs.com/package/artillery
- Repository: https://github.com/artilleryio/artillery
- Homepage: https://github.com/artilleryio/artillery#readme
- Issues: https://github.com/artilleryio/artillery/issues
- npm.io page: https://npm.io/package/artillery

## Dependencies (93)

- [ms](https://npm.io/package/ms.md) ^2.1.3
- [rc](https://npm.io/package/rc.md) ^1.2.8
- [ws](https://npm.io/package/ws.md) ^7.5.13
- [got](https://npm.io/package/got.md) ^14.6.6
- [joi](https://npm.io/package/joi.md) ^17.13.4
- [ora](https://npm.io/package/ora.md) ^4.0.4
- [uuid](https://npm.io/package/uuid.md) ^11.1.1
- [async](https://npm.io/package/async.md) ^2.6.4
- [chalk](https://npm.io/package/chalk.md) ^4.1.2
- [debug](https://npm.io/package/debug.md) ^4.4.3
- [tempy](https://npm.io/package/tempy.md) 3.2.0
- [dogapi](https://npm.io/package/dogapi.md) ^2.8.4
- [dotenv](https://npm.io/package/dotenv.md) ^16.6.1
- [espree](https://npm.io/package/espree.md) ^10.3.0
- [lodash](https://npm.io/package/lodash.md) ^4.18.0
- [moment](https://npm.io/package/moment.md) ^2.30.1
- [nanoid](https://npm.io/package/nanoid.md) ^3.3.16
- [semver](https://npm.io/package/semver.md) ^7.7.3
- [cheerio](https://npm.io/package/cheerio.md) ^1.2.0
- [ci-info](https://npm.io/package/ci-info.md) ^4.3.1
- [esprima](https://npm.io/package/esprima.md) ^4.0.1
- [filtrex](https://npm.io/package/filtrex.md) ^2.2.3
- [hpagent](https://npm.io/package/hpagent.md) ^0.1.1
- [js-yaml](https://npm.io/package/js-yaml.md) ^3.15.1
- [yaml-js](https://npm.io/package/yaml-js.md) ^0.3.1
- [arrivals](https://npm.io/package/arrivals.md) ^2.1.2
- [chokidar](https://npm.io/package/chokidar.md) ^3.6.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.3.3
- [jmespath](https://npm.io/package/jmespath.md) ^0.16.0
- [mixpanel](https://npm.io/package/mixpanel.md) ^0.18.0
- [csv-parse](https://npm.io/package/csv-parse.md) ^4.16.3
- [driftless](https://npm.io/package/driftless.md) ^2.0.3
- [form-data](https://npm.io/package/form-data.md) ^4.0.6
- [hot-shots](https://npm.io/package/hot-shots.md) ^10.2.1
- [walk-sync](https://npm.io/package/walk-sync.md) ^0.2.3
- [cli-table3](https://npm.io/package/cli-table3.md) ^0.6.5
- [playwright](https://npm.io/package/playwright.md) 1.62.1
- [protobufjs](https://npm.io/package/protobufjs.md) ^7.6.5
- [@oclif/core](https://npm.io/package/@oclif/core.md) ^4.8.0
- [cross-spawn](https://npm.io/package/cross-spawn.md) ^7.0.6
- [opentracing](https://npm.io/package/opentracing.md) ^0.14.7
- [prom-client](https://npm.io/package/prom-client.md) ^14.2.0
- [@smithy/core](https://npm.io/package/@smithy/core.md) ^3.31.1
- [esbuild-wasm](https://npm.io/package/esbuild-wasm.md) ^0.28.1
- [jsonwebtoken](https://npm.io/package/jsonwebtoken.md) ^9.0.3
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) 6.0.2
- [tough-cookie](https://npm.io/package/tough-cookie.md) ^5.1.2
- [cookie-parser](https://npm.io/package/cookie-parser.md) ^1.4.7
- [deep-for-each](https://npm.io/package/deep-for-each.md) ^3.0.0
- [eventemitter3](https://npm.io/package/eventemitter3.md) ^5.0.4
- [jsonpath-plus](https://npm.io/package/jsonpath-plus.md) ^10.3.0
- [@upstash/redis](https://npm.io/package/@upstash/redis.md) ^1.36.1
- [agentkeepalive](https://npm.io/package/agentkeepalive.md) ^4.6.0
- [@azure/identity](https://npm.io/package/@azure/identity.md) ^4.13.1
- [@faker-js/faker](https://npm.io/package/@faker-js/faker.md) 10.5.0
- [datadog-metrics](https://npm.io/package/datadog-metrics.md) ^0.12.1
- [fast-deep-equal](https://npm.io/package/fast-deep-equal.md) ^3.1.3
- [@playwright/test](https://npm.io/package/@playwright/test.md) 1.62.1
- [socket.io-client](https://npm.io/package/socket.io-client.md) ^4.8.3
- [https-proxy-agent](https://npm.io/package/https-proxy-agent.md) ^5.0.0
- [socketio-wildcard](https://npm.io/package/socketio-wildcard.md) ^2.0.0
- [@aws-sdk/client-s3](https://npm.io/package/@aws-sdk/client-s3.md) ^3.1101.0
- [@oclif/plugin-help](https://npm.io/package/@oclif/plugin-help.md) ^6.2.36
- [@opentelemetry/api](https://npm.io/package/@opentelemetry/api.md) ^1.9.0
- [@aws-sdk/client-ec2](https://npm.io/package/@aws-sdk/client-ec2.md) ^3.1101.0
- [@aws-sdk/client-ecs](https://npm.io/package/@aws-sdk/client-ecs.md) ^3.1101.0
- [@aws-sdk/client-iam](https://npm.io/package/@aws-sdk/client-iam.md) ^3.1101.0
- [@aws-sdk/client-sqs](https://npm.io/package/@aws-sdk/client-sqs.md) ^3.1101.0
- [@aws-sdk/client-ssm](https://npm.io/package/@aws-sdk/client-ssm.md) ^3.1101.0
- [@aws-sdk/client-sts](https://npm.io/package/@aws-sdk/client-sts.md) ^3.1101.0
- [@azure/storage-blob](https://npm.io/package/@azure/storage-blob.md) ^12.30.0
- [decompress-response](https://npm.io/package/decompress-response.md) ^6.0.0
- [@azure/storage-queue](https://npm.io/package/@azure/storage-queue.md) ^12.29.0
- [@aws-sdk/client-lambda](https://npm.io/package/@aws-sdk/client-lambda.md) ^3.1101.0
- [@oclif/plugin-not-found](https://npm.io/package/@oclif/plugin-not-found.md) ^3.2.73
- [@artilleryio/sketches-js](https://npm.io/package/@artilleryio/sketches-js.md) ^2.1.1
- [@opentelemetry/resources](https://npm.io/package/@opentelemetry/resources.md) ^2.10.0
- [@aws-sdk/client-cloudwatch](https://npm.io/package/@aws-sdk/client-cloudwatch.md) ^3.1101.0
- [@opentelemetry/sdk-metrics](https://npm.io/package/@opentelemetry/sdk-metrics.md) ^2.10.0
- [@azure/arm-containerinstance](https://npm.io/package/@azure/arm-containerinstance.md) ^9.1.0
- [@playwright/browser-chromium](https://npm.io/package/@playwright/browser-chromium.md) 1.62.1
- [@aws-sdk/credential-providers](https://npm.io/package/@aws-sdk/credential-providers.md) ^3.1101.0
- [@opentelemetry/sdk-trace-base](https://npm.io/package/@opentelemetry/sdk-trace-base.md) ^2.10.0
- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) ^2.10.0
- [@aws-sdk/client-cloudwatch-logs](https://npm.io/package/@aws-sdk/client-cloudwatch-logs.md) ^3.1101.0
- [@opentelemetry/context-async-hooks](https://npm.io/package/@opentelemetry/context-async-hooks.md) ^2.10.0
- [@opentelemetry/semantic-conventions](https://npm.io/package/@opentelemetry/semantic-conventions.md) ^1.43.0
- [@opentelemetry/exporter-trace-otlp-grpc](https://npm.io/package/@opentelemetry/exporter-trace-otlp-grpc.md) ^0.221.0
- [@opentelemetry/exporter-trace-otlp-http](https://npm.io/package/@opentelemetry/exporter-trace-otlp-http.md) ^0.221.0
- [@opentelemetry/exporter-trace-otlp-proto](https://npm.io/package/@opentelemetry/exporter-trace-otlp-proto.md) ^0.221.0
- [@opentelemetry/exporter-metrics-otlp-grpc](https://npm.io/package/@opentelemetry/exporter-metrics-otlp-grpc.md) ^0.221.0
- [@opentelemetry/exporter-metrics-otlp-http](https://npm.io/package/@opentelemetry/exporter-metrics-otlp-http.md) ^0.221.0
- [@opentelemetry/exporter-metrics-otlp-proto](https://npm.io/package/@opentelemetry/exporter-metrics-otlp-proto.md) ^0.221.0

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [vest](https://npm.io/package/vest.md) — 50.1K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads

## Recent versions

- 2.0.34 (latest) — 2026-08-14
- 2.0.33-117f9bc (canary) — 2026-08-14
- 2.0.33-cc50474 — 2026-08-13
- 2.0.33-d993877 — 2026-08-12
- 2.0.33-b0d196f — 2026-08-07
- 2.0.33-73ec11b — 2026-08-07
- 2.0.33-26da401 — 2026-08-07
- 2.0.33-31a0299 — 2026-08-07
- 2.0.33-670d2fa — 2026-07-14
- 2.0.33-2c19512 — 2026-07-14
- 2.0.33-a33c503 — 2026-07-13
- 2.0.33-bca0423 — 2026-07-11
- 2.0.33 — 2026-06-16
- 2.0.32-67648ae — 2026-06-16
- 2.0.32-1e6e52b — 2026-06-16
- … 633 more at https://npm.io/package/artillery/versions

## README

<div align="center">
  <img src="https://raw.githubusercontent.com/artilleryio/artillery/main/packages/artillery/artillery-logo.svg" width="80">
  <h1>Artillery</h1>
<p align="center">
  <a href="https://www.artillery.io/docs">Docs</a> | <a href="https://github.com/artilleryio/artillery/discussions">Discussions</a>
</p>

<p align="center">
  <img alt="npm" src="https://img.shields.io/npm/dm/artillery?style=flat-square">
</p>


<a href="https://www.artillery.io/">
  <img
    src="https://www.artillery.io/api/og?title=Full-stack%20reliability%20%26%20performance&description=Scalable%20API%20and%20Playwright%20load%20testing"
  />
</a>

</div>

## Features

- **Test at cloud scale.** Cloud-native distributed load testing at scale, **out-of-the box**. Scale out with AWS Lambda, AWS Fargate or Azure ACI. No DevOps needed, zero infrastructure to set up or manage.
- **Test with Playwright**. Reuse existing Playwright tests and load test with real headless browsers.
- **Batteries-included.** 20+ integrations for monitoring, observability, and CICD.
- **Test anything**. HTTP, WebSocket, Socket.io, gRPC, Kinesis, and more.
- **Powerful workload modeling**. Emulate complex user behavior with request chains, multiple steps, transactions, and more.
- **Extensible & hackable**. Artillery has a plugin API to allow extending and customization.

## Get started

### Install Artillery

```
npm install -g artillery
```

### Run your first test

Follow our 5-minute guide to run your first load test - https://www.artillery.io/docs/get-started/first-test

## Learn more

### Docs and guides

- [Load testing with Playwright](https://www.artillery.io/docs/playwright)
- Distributed load testing with Artillery on [AWS Lambda](https://docs.art/lambda), [AWS Fargate](https://docs.art/fargate), or [Azure ACI](https://docs.art/azure)
- Set [API response expectations](https://docs.art/expect), automate [SLO checks](https://docs.art/ensure), and report [Apdex scores](https://docs.art/apdex)
- [Publishing metrics](https://docs.art/o11y) to Datadog, New Relic, Honeycomb, and any other OTel-compatible platform

### Integrations and plugins

We maintain a list of official and community-built [integrations and plugins](https://www.artillery.io/integrations) on our website: https://www.artillery.io/integrations.

### Example tests

You can find a list of ready-to-run Artillery examples under [`examples/`](https://github.com/artilleryio/artillery/tree/master/examples#readme).

---
_Source: https://npm.io/package/artillery · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._