Skip to content
Resource scheduling and cluster management for AI
JavaScript Python Java Shell Go TypeScript Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.dependabot Update dependabot config file (#2914) Jun 11, 2019
.github Migrate CI from Travis to GitHub Actions (#3370) Aug 14, 2019
build Add error message when image build failed (#2133) Feb 12, 2019
contrib Add custom config support for users (#3583) Sep 11, 2019
deployment Remove password from stdin in paictl (#3577) Sep 6, 2019
docs Fix a bug of how to build DevBox Doc (#3607) Sep 11, 2019
examples [pylon] Configurable pylon uri (#3533) Sep 3, 2019
marketplace-v2 Add a horovod mpi example in marketplace (#3568) Sep 6, 2019
marketplace Delete cntk_g2p.yaml from marketplace for it always failed; (#1526) Oct 17, 2018
src [Web Portal] Add frameworkName tooltip on job detail page (#3619) Sep 12, 2019
subprojects Chinese translation updates (#3424) Aug 23, 2019
version update pai version Jul 3, 2019
.gitattributes Add service deployment for framework controller (#3435) Sep 2, 2019
.gitignore Add Notebook Extension (#3418) Aug 23, 2019
.travis.yml Add CI workflow for GitHub Actions (#3363) Aug 13, 2019
Jenkinsfile Fix dev-box (#3388) Aug 16, 2019
LICENSE Initial commit Sep 25, 2017 [doc] Fix typos and dependicies (#3421) Aug 22, 2019 Chinese translation updates (#3424) Aug 23, 2019 change link of external project like python sdk (#3237) Jul 22, 2019 Chinese translation updates (#3424) Aug 23, 2019
crowdin.yml Chinese translation updates (#3424) Aug 23, 2019 [Job Debugging] Basic Implement Of Job Debugging. (#2272) Mar 7, 2019
pailogo.jpg add logo Apr 18, 2018
sysarch.png update system architecture section Nov 24, 2017

Open Platform for AI (OpenPAI) alt text

Build Status Coverage Status Join the chat at Version


OpenPAI is an open source platform that provides complete AI model training and resource management capabilities, it is easy to extend and supports on-premise, cloud and hybrid environments in various scale.

OpenPAI v0.14.0 has been released!

Table of Contents

  1. When to consider OpenPAI
  2. Why choose OpenPAI
  3. Get started
  4. Deploy OpenPAI
  5. Train models
  6. Administration
  7. Reference
  8. Get involved
  9. How to contribute

When to consider OpenPAI

  1. When your organization needs to share powerful AI computing resources (GPU/FPGA farm, etc.) among teams.
  2. When your organization needs to share and reuse common AI assets like Model, Data, Environment, etc.
  3. When your organization needs an easy IT ops platform for AI.
  4. When you want to run a complete training pipeline in one place.

Why choose OpenPAI

The platform incorporates the mature design that has a proven track record in Microsoft's large-scale production environment.

Support on-premises and easy to deploy

OpenPAI is a full stack solution. OpenPAI not only supports on-premises, hybrid, or public Cloud deployment but also supports single-box deployment for trial users.

Support popular AI frameworks and heterogeneous hardware

Pre-built docker for popular AI frameworks. Easy to include heterogeneous hardware. Support Distributed training, such as distributed TensorFlow.

Most complete solution and easy to extend

OpenPAI is a most complete solution for deep learning, support virtual cluster, compatible Hadoop / Kubernetes eco-system, complete training pipeline at one cluster etc. OpenPAI is architected in a modular way: different module can be plugged in as appropriate.

Related Projects

Targeting at openness and advancing state-of-art technology, Microsoft Research (MSR) and Microsoft Search Technology Center (STC) had also released few other open source projects.

  • NNI : An open source AutoML toolkit for neural architecture search and hyper-parameter tuning. We encourage researchers and students leverage these projects to accelerate the AI development and research.
  • MMdnn : A comprehensive, cross-framework solution to convert, visualize and diagnose deep neural network models. The "MM" in MMdnn stands for model management and "dnn" is an acronym for deep neural network.
  • NeuronBlocks : An NLP deep learning modeling toolkit that helps engineers to build DNN models like playing Lego. The main goal of this toolkit is to minimize developing cost for NLP deep neural network model building, including both training and inference stages.
  • SPTAG : Space Partition Tree And Graph (SPTAG) is an open source library for large scale vector approximate nearest neighbor search scenario.

Get started

OpenPAI manages computing resources and is optimized for deep learning. Through docker technology, the computing hardware are decoupled with software, so that it's easy to run distributed jobs, switch with different deep learning frameworks, or run other kinds of jobs on consistent environments.

As OpenPAI is a platform, deploy a cluster is first step before using. A single server is also supported to deploy OpenPAI and manage its resource.

If the cluster is ready, learn from train models about how to use it.

Deploy OpenPAI

Follow this part to check prerequisites, deploy and validate an OpenPAI cluster. More servers can be added as needed after initial deployed.

It's highly recommended to try OpenPAI on server(s), which has no usage and service. Refer to here for hardware specification.

Prerequisites and preparation

  • Ubuntu 16.04 (18.04 should work, but not fully tested.)
  • Assign each server a static IP address, and make sure servers can communicate each other.
  • Server can access internet, especially need to have access to the docker hub registry service or its mirror. Deployment process will pull Docker images of OpenPAI.
  • SSH service is enabled and share the same username/password and have sudo privilege.
  • NTP service is enabled.
  • Recommend not to install docker or docker's version must be higher than 1.26.
  • OpenPAI reserves memory and CPU for service running, so make sure there are enough resource to run machine learning jobs. Check hardware requirements for details.
  • Dedicated servers for OpenPAI. OpenPAI manages all CPU, memory and GPU resources of servers. If there is any other workload, it may cause unknown problem due to insufficient resource.


The Deploy with default configuration part is minimum steps to deploy an OpenPAI cluster, and it's suitable for most small and middle size clusters within 50 servers. Base on the default configuration, the customized deployment can optimize the cluster for different hardware environments and use scenarios.

Deploy with default configuration

For a small or medium size cluster, which is less than 50 servers, it's recommended to deploy with default configuration. if there is only one powerful server, refer to deploy OpenPAI as a single box.

For a large size cluster, this section is still needed to generate default configuration, then customize the deployment.

Customize deployment

As various hardware environments and different use scenarios, default configuration of OpenPAI may need to be optimized. Following Customize deployment part to learn more details.

Validate deployment

After deployment, it's recommended to validate key components of OpenPAI in health status. After validation is success, submit a hello-world job and check if it works end-to-end.

Train users before "train models"

The common practice on OpenPAI is to submit job requests, and wait jobs got computing resource and executed. It's different experience with assigning dedicated servers to each one. People may feel computing resource is not in control and the learning curve may be higher than run job on dedicated servers. But shared resource on OpenPAI can improve utilization of resources and save time on maintaining environments.

For administrators of OpenPAI, a successful deployment is first step, the second step is to let users of OpenPAI understand benefits and know how to use it. Users can learn from Train models. But below section of training models is for various scenarios and maybe users don't need all of them. So, administrators can create simplified documents as users' actual scenarios.


If there is any question during deployment, check here firstly.

If FAQ doesn't resolve it, refer to here to ask question or submit an issue.

Train models

As all computing platforms, OpenPAI is a productive tool and to maximize utilization of resources. So, it's recommended to submit training jobs and let OpenPAI to allocate resource and run jobs. If there are too many jobs, some jobs may be queued until enough resource available. This is different experience with running code on dedicated servers, so it needs a bit more knowledge about how to submit and manage jobs on OpenPAI.

Note, besides queuing jobs, OpenPAI also supports to allocate dedicated resources. Users can use SSH or Jupyter Notebook like on a physical server, refer to here for details. Though it's not efficient to use resources, but it also saves cost on setup and managing environments on physical servers.

Submit training jobs

Follow the job submission tutorial to learn more how to train models on OpenPAI. It's a good start to learn How to use OpenPAI.

Client tool

OpenPAI VS Code Client is a friendly, GUI based client tool of OpenPAI, and it's highly recommended. It's an extension of Visual Studio Code. It can submit job, simulate jobs locally, manage multiple OpenPAI environments, and so on.

Troubleshooting job failure

Web UI and job log are helpful to analyze job failure, and OpenPAI supports SSH for debugging.

Refer to here for more information about troubleshooting job failure.




Get involved

How to contribute

Contributor License Agreement

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.

Call for contribution

We are working on a set of major features improvement and refactor, anyone who is familiar with the features is encouraged to join the design review and discussion in the corresponding issue ticket.

Who should consider contributing to OpenPAI

  • Folks who want to add support for other ML and DL frameworks
  • Folks who want to make OpenPAI a richer AI platform (e.g. support for more ML pipelines, hyperparameter tuning)
  • Folks who want to write tutorials/blog posts showing how to use OpenPAI to solve AI problems


One key purpose of PAI is to support the highly diversified requirements from academia and industry. PAI is completely open: it is under the MIT license. This makes PAI particularly attractive to evaluate various research ideas, which include but not limited to the components.

PAI operates in an open model. It is initially designed and developed by Microsoft Research (MSR) and Microsoft Search Technology Center (STC) platform team. We are glad to have Peking University, Xi'an Jiaotong University, Zhejiang University, and University of Science and Technology of China join us to develop the platform jointly. Contributions from academia and industry are all highly welcome.

You can’t perform that action at this time.