How to Run Pytest Tests in Parallel?

Better Stack Team
Updated on July 18, 2024

To run Pytest tests in parallel, install the pytest-xdist plugin:

 
pip install pytest-xdist

Use the following command to run tests in parallel:

 
pytest -n auto

The -n auto option tells Pytest to distribute the tests across as many CPUs as your machine has available.

If you want more control and wish to specify the number of CPUs yourself, you can pass a number instead of auto:

 
pytest -n <NUM>

Make your mark

Join the writer's program

Are you a developer and love writing and sharing your knowledge with the world? Join our guest writing program and get paid for writing amazing technical guides. We'll get them to the right readers that will appreciate them.

Write for us
Writer of the month
Marin Bezhanov
Marin is a software engineer and architect with a broad range of experience working...
Build on top of Better Stack

Write a script, app or project on top of Better Stack and share it with the world. Make a public repository and share it with us at our email.

community@betterstack.com

or submit a pull request and help us build better products for everyone.

See the full list of amazing projects on github