Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

tox

tox.wiki

  • Free plan
  • Windows
  • macOS
  • Linux
7.4 Club score Visit tox.wiki

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

tox

Free

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.