Scroll to navigation

TOX(1) Project name not set TOX(1)

NAME

tox - virtualenv-based automation of test activities

SYNOPSIS

tox [options] [command [command-options]]

DESCRIPTION

tox aims to automate and standardize testing in Python. It is part of a larger vision of easing the packaging, testing and release process of Python software.

tox creates virtual environments for multiple Python versions, installs project dependencies, and runs tests in each environment. It supports parallel execution, custom test commands, and extensive configuration.

COMMANDS

Execute test environments. This is the default command if none is specified.
List configured environments with their descriptions.
Show tox configuration details for debugging and inspection.
Execute a command in a tox environment without running the full test suite.
Create a development environment from a tox environment definition.
Legacy tox 3.x compatibility mode for older configurations.

For command-specific help, use: tox command --help

OPTIONS

For a complete list of options, run tox --help or see the online documentation at <https://tox.wiki/>

Common options:

Show help message and exit.
Increase verbosity (can be used multiple times).
Decrease verbosity (can be used multiple times).
Recreate the test environment.
Run specific test environments (comma-separated).
Configuration file to use.
tox working directory (default: .tox).
Override a configuration value.

FILES

Primary configuration file in TOML format (recommended).
Configuration file in INI format.
Alternative configuration location under the [tool.tox] section.
Legacy configuration location (deprecated).

The configuration files are searched in the order listed above. The first file found is used.

ENVIRONMENT VARIABLES

Any tox configuration setting can be overridden via environment variables with the TOX_ prefix. For example, TOX_SKIP_ENV can override the skip_env setting.
When set to any non-empty value, disables colored output.
When set to any non-empty value, forces colored output even when stdout is not a terminal.
When set, disables the progress spinner during parallel execution.

SEE ALSO

Full documentation: <https://tox.wiki/>

pip(1), pytest(1), virtualenv(1)

Author

tox development team

Copyright

tox-dev

March 16, 2026 4.49