Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Seamless integration of tox into GitHub Actions for tox 3 and 4
| Date | Stars |
|---|---|
| 2026-07-24 | 256 |
| 2026-07-25 | 256 |
| 2026-07-28 | 256 |
| 2026-07-30 | 256 |
| 2026-08-06 | 256 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
0.0
growth rate 0.00%/day
# tox-gh-actions <!-- omit in toc -->
[](https://badge.fury.io/py/tox-gh-actions)
[](https://pypi.python.org/pypi/tox-gh-actions/)
[](https://github.com/ymyzk/tox-gh-actions/actions/workflows/tests.yml)
[](https://codecov.io/gh/ymyzk/tox-gh-actions)
**tox-gh-actions** is a tox plugin which helps running tox on GitHub Actions
with multiple different Python versions on multiple workers in parallel.
This project is inspired by [tox-travis](https://github.com/tox-dev/tox-travis).
- [Features](#features)
- [Usage](#usage)
- [Examples](#examples)
- [Basic Example](#basic-example)
- [tox-gh-actions Configuration](#tox-gh-actions-configuration)
- [Workflow Configuration](#workflow-configuration)
- [Advanced Examples](#advanced-examples)
- [Factor-Conditional Settings: Python Version](#factor-conditional-settings-python-version)
- [Factor-Conditional Settings: Environment Variable](#factor-conditional-settings-environment-variable)
- [tox requires](#tox-requires)
- [Overriding Environments to Run](#overriding-environments-to-run)
- [Versioning](#versioning)
- [Versions and Compatibility](#versions-and-compatibility)
- [Understanding Behavior of tox-gh-actions](#understanding-behavior-of-tox-gh-actions)
- [How tox-gh-actions Works](#how-tox-gh-actions-works)
- [Logging](#logging)
## Features
When running tox on GitHub Actions, tox-gh-actions
* detects which environment to run based on configurations and
* provides utilities such as [grouping log lines](https://github.com/actions/toolkit/blob/main/docs/commands.md#group-and-ungroup-log-lines).
## Usage
1. Add configurations under `[gh-actions]` section along with tox's configuration.
- It will be `pyproject.toml`, `tox.ini`, or `setup.cfg`. See [tox's documentation](https://tox.wiki/en/latest/config.html) for more details.
2. Install `tox-gh-actions` package in the GitHub Actions workflow before running `tox` command.
## Examples
### Basic Example
The following configuration will create 3 jobs when running the workflow on GitHub Actions.
- On Python 3.10 job, tox runs `py310` environment
- On Python 3.12 job, tox runs `py312` environment
- On Python 3.14 job, tox runs `py314` and `mypy` environments
#### tox-gh-actions Configuration
Add `[gh-actions]` section to the same file as tox's configuration.
If you're using `tox.ini`:
```ini
[tox]
envlist = py310, py312, py314, mypy
[gh-actions]
python =
3.10: py310
3.12: py312
3.14: py314, mypy
[testenv]
...
```
If you're using `setup.cfg`:
```ini
[tox:tox]
envlist = py310, py312, py314, mypy
[gh-actions]
python =
3.10: py310
3.12: py312
3.14: py314, mypy
[testenv]
...
```
If you're using `pyproject.toml`:
```toml
[tool.tox]
legacy_tox_ini = """
[tox]
envlist = py310, py312, py314, mypy
[gh-actions]
python =
3.10: py310
3.12: py312
3.14: py314, mypy
[testenv]
"""
```
#### Workflow Configuration
`.github/workflows/<workflow>.yml`:
```yaml
name: Python package
on:
- push
- pull_request
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ['3.10', '3.12', '3.14']
steps:
- uses: actions/checkout@v5
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
- name: Install dependencies
run: |
python -m pip install --upgrade pip
python -m pip install tox tox-gh-actions
- name: Test with tox
run: tox
```
### Advanced Examples
#### Factor-Conditional Settings: Python Version
The following configuration will create 2 jobs when runniExcerpt of 10,187 characters
Read on GitHubWould you bet a product on this? Bounded 0–100 and slow moving.
matched fp:4549a37760ad0b82, topic:testing