ClusterRunner makes it easy to parallelize test suites across your infrastructure in the fastest and most efficient way possible.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples/directory job Implement max_executors_per_slave job conf setting Jan 6, 2015
.dockerignore Fix autoversion bugs in release steps (#435) Apr 27, 2018
LICENSE First commit - seeding ClusterRunner repo with initial version Oct 21, 2014
Makefile Fix a tiny typo Mar 26, 2018
pylintrc Add pip-tools to manage dependency versioning (#444) Jun 26, 2018
requirements.txt Deploy shell scripts to /var/lib/clusterrunner/bin (#430) Apr 24, 2018

Project Status Build Status Build status Coverage Status


ClusterRunner makes it easy to execute test suites across your infrastructure in the fastest and most efficient way possible.

By using ClusterRunner in your testing pipeline, you will be able to easily:

  • Make long-running, single-threaded test jobs run in parallel.
  • Consistently utilize 100% of your testing infrastructure.
  • Get test feedback faster.
  • Completely isolate tests from each other, avoiding nasty global state.

The entire process of installing, initializing, and executing tests through ClusterRunner should take about 8 minutes!

Give it a shot by starting at our documentation site.

Read the Docs

You can find all our official documentation at

For a quick visual overview, check out the infographic we presented at the PyCon 2015 poster session:


ClusterRunner currently has no built-in UI, but its extensive API allows you to create detailed dashboards so you can monitor your cluster and see what it's doing.

We've open-sourced a few of the dashboards we use internally at Box for monitoring our own clusters. Check out the ClusterRunner-Dashboard repo for the code and documentation.


We ❤️ external contributors! You can run ClusterRunner entirely locally and it has a comprehensive functional test suite, so it's easy to get started. Take a look at our open issues to get an idea of where you can help out.

Get Help

We're happy to answer any questions you have around setting up ClusterRunner in your own org. Create a new issue on this repo, or email and be sure to include "ClusterRunner" in the subject.

Copyright and License

Copyright 2014 Box, Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.