Getting started

Three commands cover the basics:

$ pip install rstest
$ rstest                      # parallel run, pytest config honored
$ rstest --doctor             # and find out why the suite is slow

(--doctor shines on a real suite, not a toy two-test folder — see the diagnostics guide.)

• Installation — requirements, pip/uv, from source
• Your first test — no suite yet? from an empty folder to a green run
• First steps — already have a pytest suite? running, reading output, selecting tests
• Features — what rstest adds over pytest
• Glossary — worker, byte-exact, long-pole, and the other terms
• Troubleshooting — first-run errors and common fixes
• Getting help

Coming from pytest? The migration guide is the page to read — or, in a project that already has pytest and a suite installed, run rstest --try for a 30-second "is it worth switching?" answer.