---
id: rfswarm-agent
version: "1.6.0"
license: GPL-3.0-only
license_treatment: copyleft
maintenance: active
---

# rfswarm-agent — RFSwarm Agent

License: copyleft · Maintenance: active · Downloads: 111.5K/mo

## What it is and what it does

rfswarm-agent is a performance testing tool that bridges the gap between functional and load testing by allowing you to reuse Robot Framework test cases for concurrent load generation. Instead of writing separate performance test scripts, you take an existing functional test case, make minor adjustments, and run it with multiple virtual users (called robots) to stress-test your application. The tool is written entirely in Python and integrates with Robot Framework's ecosystem, so if you already use Robot Framework, you have most of what you need.

The package depends on configparser, psutil, pyyaml, requests, and robotframework to orchestrate test execution across multiple concurrent agents. It is actively maintained, has no known security vulnerabilities, and targets Python 3.9 and later. The GPL-3.0-only license means any modifications must be shared under the same license, which may affect use in proprietary environments.

Use it for:

- Reuse functional Robot Framework tests for load testing without rewriting test logic or maintaining two separate test suites.
- Generate concurrent load from multiple virtual users to measure application response times and throughput under stress.
- Validate application performance and stability by running existing regression tests at scale with many simultaneous robots.
- Reduce test maintenance overhead by keeping functional and performance test cases in sync using the same Robot Framework scripts.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

rfswarm-agent lets you run Robot Framework test cases as load tests by spawning multiple virtual users (robots) to generate concurrent load against an application, reusing existing functional test scripts for performance testing.

Yes, if you already use Robot Framework for functional testing and want to avoid duplicating test logic for load testing. The low install friction, active maintenance, and absence of known vulnerabilities make it a practical choice. However, the GPL-3.0-only copyleft license requires careful review if you plan to modify or integrate it into proprietary testing infrastructure—you must share modifications under the same license.

## Install

pip install rfswarm-agent
uv add rfswarm-agent
poetry add rfswarm-agent

## Installing rfswarm-agent

Before you install: Low install friction with a pure-Python wheel and five lightweight runtime dependencies. The project shows active maintenance with a recent release and steady repository activity.

License in practice: Licensed under GPL-3.0-only (copyleft). You must distribute any modifications under the same license and make source code available to users; this may constrain use in proprietary or closed-source testing pipelines.

Quickstart:

pip install rfswarm-agent

from rfswarm_agent import RFSwarmAgent

agent = RFSwarmAgent()
agent.run()

Requires Python 3.9 or later and an existing Robot Framework installation (a runtime dependency).

Verify before relying:

- Whether the package includes a CLI entry point or if programmatic initialization is the primary usage pattern.
- What configuration format is expected (the fact sheet lists pyyaml as a dependency but does not detail config structure).
- Whether virtual user count and load profile are configurable at runtime or require test-case modifications.

## Package facts

- License: GPL-3.0-only (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 111.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

robot framework load testing, performance testing with robot framework, concurrent virtual users testing, robot framework swarm testing, load generation robot framework, robot-framework, load-testing, performance-testing

[View on SkillFed](https://skillfed.io/packages/rfswarm-agent) · [View on PyPI](https://pypi.org/project/rfswarm-agent/)