https://github.com/tox-dev/tox

Command line driven CI frontend and development task automation tool.
https://github.com/tox-dev/tox

actions automation cli continuous-integration python testing venv virtualenv

Last synced: 11 days ago
JSON representation

Command line driven CI frontend and development task automation tool.

• Host: GitHub
• URL: https://github.com/tox-dev/tox
• Owner: tox-dev
• License: mit
• Created: 2016-09-17T16:54:22.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2026-04-27T16:54:15.000Z (16 days ago)
• Last Synced: 2026-04-28T11:57:06.776Z (15 days ago)
• Topics: actions, automation, cli, continuous-integration, python, testing, venv, virtualenv
• Language: Python
• Homepage: https://tox.wiki
• Size: 15.1 MB
• Stars: 3,916
• Watchers: 37
• Forks: 551
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yaml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: .github/SECURITY.md

Awesome Lists containing this project

• awesome-python - tox - Auto builds and tests distributions in multiple Python versions (Testing)
• awesome-python - tox - Auto builds and tests in multiple environments (Testing / Test Runners)
• awesomeLibrary - tox - Command line driven CI frontend and development task automation tool. (语言资源库 / python)
• awesome-starred - tox - Command line driven CI frontend and development task automation tool. (Python)
• awesome-open-source-applications - Tox - dev/tox) |  |  |  |  | (Back-End Development)
• awesome-python-fa - **tox** - ابزار خودکار برای تست در چند محیط پایتونی. این کتابخانه به شما کمک می‌کند تا کد خود را در نسخه‌های مختلف پایتون تست کنید. (📚 فهرست / تست و دیباگ)
• awesome-django - tox
• fucking-awesome-python - tox - Auto builds and tests distributions in multiple Python versions (Testing)
• best-of-python-dev - GitHub - 0% open · ⏱️ 23.04.2026): (Testing Tools)

README

          
# 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.