# tox

> tox is a generic virtualenv management and test command line tool

- **URL**: https://www.freshcrate.ai/projects/tox
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `4.55.1` (2026-06-03)
- **License**: Unknown
- **Source**: https://github.com/tox-dev/tox
- **Homepage**: https://pypi.org/project/tox/
- **Language**: Python
- **GitHub**: 3,914 stars, 550 forks
- **Registry**: pypi (`tox`)
- **Tags**: `environments`, `isolated`, `pypi`, `testing`, `virtual`

## Description

# tox

[![PyPI](https://img.shields.io/pypi/v/tox)](https://pypi.org/project/tox/)
[![Supported Python
versions](https://img.shields.io/pypi/pyversions/tox.svg)](https://pypi.org/project/tox/)
[![Downloads](https://static.pepy.tech/badge/tox/month)](https://pepy.tech/project/tox)
[![Documentation
status](https://readthedocs.org/projects/tox/badge/?version=latest)](https://tox.readthedocs.io/en/latest/?badge=latest)
[![check](https://github.com/tox-dev/tox/actions/workflows/check.yaml/badge.svg)](https://github.com/tox-dev/tox/actions/workflows/check.yaml)

`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 (alongside [pytest](https://docs.pytest.org/en/latest/) and
[devpi](https://www.devpi.net)).

tox is a generic virtual environment management and test command line tool you can use for:

- checking your package builds and installs correctly under different environments (such as different Python
  implementations, versions or installation dependencies),
- running your tests in each of the environments with the test tool of choice,
- acting as a frontend to continuous integration servers, greatly reducing boilerplate and merging CI and shell-based
  testing.

Please read our [user guide](https://tox.wiki/en/latest/tutorial/getting-started.html) for an example and more detailed
introduction, or watch [this YouTube video](https://www.youtube.com/watch?v=SFqna5ilqig) that presents the problem space
and how tox solves it.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `4.55.1` | 2026-06-03 | High | <!-- Release notes generated using configuration in .github/release.yaml at 4.55.1 -->  ## What's Changed * 🐛 fix(config): propagate overrides through config references by @tales-aparecida in https://github.com/tox-dev/tox/pull/3951  ## New Contributors * @tales-aparecida made their first contribution in https://github.com/tox-dev/tox/pull/3951  **Full Changelog**: https://github.com/tox-dev/tox/compare/4.55.0...4.55.1 |
| `4.55.0` | 2026-05-28 | High | <!-- Release notes generated using configuration in .github/release.yaml at 4.55.0 -->  ## What's Changed * 👷 ci(schemastore): sync fork before pushing branch by @gaborbernat in https://github.com/tox-dev/tox/pull/3942 * feat: Also pass `TERMINFO` when in an interactive shell by @edgarrmondragon in https://github.com/tox-dev/tox/pull/3946 * 🐛 fix(pip): skip constrain_package_deps when constraints is set by @gaborbernat in https://github.com/tox-dev/tox/pull/3948   **Full Changelog**: https://g |
| `4.54.0` | 2026-05-12 | High | <!-- Release notes generated using configuration in .github/release.yaml at 4.54.0 -->  ## What's Changed * 🧪 test(conftest): strip broken nspkg.pth files under py3.15 by @gaborbernat in https://github.com/tox-dev/tox/pull/3937 * ✨ feat(packaging): declare tox.pytest deps via a testing extra by @gaborbernat in https://github.com/tox-dev/tox/pull/3940 * 🐛 fix(schema): cover every replace form in the TOML schema by @gaborbernat in https://github.com/tox-dev/tox/pull/3941   **Full Changelog**: ht |
| `4.53.1` | 2026-05-02 | High | <!-- Release notes generated using configuration in .github/release.yaml at 4.53.1 -->  ## What's Changed * 🐛 fix(security): harden user-facing logs and untrusted inputs by @gaborbernat in https://github.com/tox-dev/tox/pull/3924 * 🐛 fix(type): correct argparse override signatures for ty 0.0.33 by @gaborbernat in https://github.com/tox-dev/tox/pull/3932 * fix: allow deps arrays in TOML schema by @cyphercodes in https://github.com/tox-dev/tox/pull/3931  ## New Contributors * @cyphercodes made t |
| `4.53.0` | 2026-04-21 | Low | Imported from PyPI (4.53.0) |
| `4.52.1` | 2026-04-09 | Medium | <!-- Release notes generated using configuration in .github/release.yaml at 4.52.1 -->  ## What's Changed * use normalize_isa for architecture factor matching by @rahuldevikar in https://github.com/tox-dev/tox/pull/3919 * 🐛 fix(pip): invalidate install cache on resolution env var changes by @gaborbernat in https://github.com/tox-dev/tox/pull/3921   **Full Changelog**: https://github.com/tox-dev/tox/compare/4.52.0...4.52.1 |
| `4.52.0` | 2026-03-30 | Medium | <!-- Release notes generated using configuration in .github/release.yaml at 4.52.0 -->  ## What's Changed * remove unsupported --remote flag from gh repo fork by @rahuldevikar in https://github.com/tox-dev/tox/pull/3908 * ✨ feat(config): support escaped dots in -x override keys by @gaborbernat in https://github.com/tox-dev/tox/pull/3910 * 🐛 fix(docs): auto-generate manpage from CLI parser by @gaborbernat in https://github.com/tox-dev/tox/pull/3911 * ✨ feat(runner): add PEP 723 inline script met |
| `4.51.0` | 2026-03-27 | Medium | <!-- Release notes generated using configuration in .github/release.yaml at 4.51.0 -->  ## What's Changed * 🔒 ci(workflows): add zizmor security auditing by @gaborbernat in https://github.com/tox-dev/tox/pull/3896 * Add `base_python_file` config option by @rahuldevikar in https://github.com/tox-dev/tox/pull/3899 * prevent machine ISA from overriding explicit env factors by @rahuldevikar in https://github.com/tox-dev/tox/pull/3904 * 🐛 fix(config): fix handling of env_list in nested contexts by |
| `4.50.3` | 2026-03-20 | Low | <!-- Release notes generated using configuration in .github/release.yaml at 4.50.3 -->  ## What's Changed * 🐛 fix(pkg): distinguish free-threaded Python in wheel build env by @gaborbernat in https://github.com/tox-dev/tox/pull/3891   **Full Changelog**: https://github.com/tox-dev/tox/compare/4.50.2...4.50.3 |
| `4.50.2` | 2026-03-19 | Low | <!-- Release notes generated using configuration in .github/release.yaml at 4.50.2 -->  ## What's Changed * fix(sdist): include `docs/man/tox.1.rst` by @branchv in https://github.com/tox-dev/tox/pull/3890  ## New Contributors * @branchv made their first contribution in https://github.com/tox-dev/tox/pull/3890  **Full Changelog**: https://github.com/tox-dev/tox/compare/4.50.1...4.50.2 |

## Citation

- HTML: https://www.freshcrate.ai/projects/tox
- Markdown: https://www.freshcrate.ai/projects/tox.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/tox/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._
