Skip to content


Repository files navigation

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.


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








No packages published