tox
tox.wiki
- Free plan
- Windows
- macOS
- Linux
What tox is
tox is a free, open-source command-line tool for creating isolated environments, checking package builds and installations, and running tests across Linux, macOS, and Windows. It can coordinate test runners, linters, formatters, documentation generators, and build or publishing tools. tox can also front continuous integration servers, combining CI workflows with shell-based testing while reducing setup boilerplate. Configuration may be stored in tox.toml, tox.ini, pyproject.toml, or toxfile.py. By default, it removes host environment variables unless they are allowed through pass_env and changes PATH so commands use the active environment. The command-line tool requires Python 3.10 or newer. Installation guidance covers pipx, uv, and pip, with apt and brew package-manager routes also documented. Plugins include GitHub Actions integration and tox-uv for package installation. tox supports lockfiles, dependency groups, and environment management.
Who it suits
tox suits developers and teams that need repeatable environments, package checks, and tests across operating systems. It also fits projects connecting local testing with continuous integration workflows.
Good to know, and what to watch
- Free and open-source
- Runs on Linux, macOS, and Windows
- Coordinates tests, linters, and builds
- Supports several configuration file formats
- Integrates with GitHub Actions
- Requires Python 3.10 or higher
- No free trial; it is a command-line tool
- Volunteer-maintained project
Plans
Every plan and pricetox
Open source
The verdict
tox brings environment setup, package validation, and test orchestration into one configurable command-line tool. Its cross-platform support and CI integrations suit development teams standardizing checks across environments.
What the maker publishes
- CI use
- tox can act as a frontend to continuous integration servers, reducing boilerplate and combining CI and shell-based testing. source
- CLI and platform evidence
- The development guide documents running tox from a source checkout on Linux and Windows; the installation guide also describes package-manager installation with apt and brew. source
- Configuration
- tox reads configuration from files including tox.toml, tox.ini, pyproject.toml, and toxfile.py. source
- Environment isolation
- By default, tox removes host environment variables unless allowed through pass_env and adjusts PATH so commands resolve inside the active environment. source
- Environment orchestration
- tox can set up environments and invoke test runners, linters, formatters, documentation generators, and build and publishing tools. source
- GitHub Actions integration
- The tox-gh-actions plugin integrates tox with GitHub Actions for CI workflows. source
- Installation options
- The installation guide recommends pipx or uv for installing tox in an isolated environment and also provides pip instructions. source
- Man page
- tox includes a compiled man page in its wheel, and package managers such as apt and brew install it in an appropriate system location. source
- Plugin ecosystem
- tox supports plugins, including tox-uv for faster package installation and tox-gh for enhanced GitHub integration across environments. source
- Purpose
- tox manages virtual environments, checks package builds and installations across different environments, and runs tests in those environments. source
- Python requirement
- The tox command-line tool requires Python 3.10 or higher. source
- Support
- The development guide describes tox as a volunteer-maintained open-source project and directs people with issues to the issue tracker. source
Checked against the maker's pages on 10 Oct 2026.