---
id: pytest-circleci-parallelized
version: "0.1.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pytest-circleci-parallelized — Parallelize pytest across CircleCI workers.

License: permissive · Maintenance: abandoned · Downloads: 161.1K/mo

## What it is and what it does

pytest-circleci-parallelized is a pytest plugin that integrates with CircleCI's native test parallelization. When you run pytest with the `--circleci-parallelize` flag, it automatically splits your test suite across the worker nodes you've configured in CircleCI, using CircleCI's `circleci tests split` utility to determine which tests each node should run.

The plugin is designed for teams already using CircleCI and wanting to leverage its parallelism feature without manually managing test distribution. It has no runtime dependencies and works with Python 2.7 and 3.4 and later. However, the project has been abandoned since October 2022 and receives no maintenance, which creates uncertainty about compatibility with current CircleCI and pytest releases.

Use it for:

- Speed up test execution in CircleCI by distributing test files across multiple worker nodes automatically.
- Reduce overall CI pipeline duration when running large test suites on CircleCI without manual test splitting logic.
- Integrate CircleCI's native test splitting into pytest workflows without writing custom parallelization code.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds a pytest plugin that automatically distributes tests across CircleCI worker nodes using CircleCI's built-in test splitting utility.

No. The package is abandoned (last commit 2022-10-20) and has received no maintenance for over 1394 days. While it has no known vulnerabilities and a permissive MIT license, its viability with modern CircleCI and pytest versions is unverified. For new projects, consider CircleCI's native test splitting or maintained alternatives; for existing projects still using it, evaluate whether it still works with your current toolchain before relying on it.

## Install

pip install pytest-circleci-parallelized
uv add pytest-circleci-parallelized
poetry add pytest-circleci-parallelized

## Installing pytest-circleci-parallelized

Before you install: High install friction with no runtime dependencies. The package is abandoned—last commit was 2022-10-20, over 1394 days ago—and has not received maintenance updates despite being in active use. Relies on CircleCI's `circleci tests split` command being available in your CI environment.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install pytest-circleci-parallelized

# In .circleci/config.yml:
# - run: pytest --circleci-parallelize

Requires CircleCI as your CI platform and the circleci CLI tool available in your build environment; does not work with other CI systems.

Verify before relying:

- Whether the package still works with modern CircleCI and pytest versions given its abandonment since 2022.
- Compatibility with Python versions beyond 3.7 despite classifiers claiming support for 2.7 and 3.4–3.7.
- Whether CircleCI's test splitting API or command has changed since the last release.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: abandoned
- Downloads: 161.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest circleci parallel, distribute tests across circleci workers, circleci test splitting pytest, pytest parallelization circleci, split pytest suite circleci, circleci parallelism pytest plugin, circleci-integration, test-parallelization, abandoned

[View on SkillFed](https://skillfed.io/packages/pytest-circleci-parallelized) · [View on PyPI](https://pypi.org/project/pytest-circleci-parallelized/)