---
id: coveralls
version: "4.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# coveralls — Show coverage stats online via coveralls.io

License: permissive · Maintenance: active · Downloads: 1.2M/mo

## What it is and what it does

Coveralls is a Python client that publishes test coverage reports to the coveralls.io service. It wraps coverage.py output and sends it to coveralls.io's servers, allowing teams to track coverage metrics over time and across builds. The package integrates into typical test workflows: you run coverage.py to generate metrics, then invoke coveralls to upload them. It depends on coverage, requests, and typer.

The package is designed for CI/CD pipelines where coverage reports need to be centralized and visualized. It requires Python 3.10 or later and is actively maintained with no known security vulnerabilities. Installation is straightforward and install friction is low.

Use it for:

- Publish coverage reports from CI/CD pipelines to track test coverage trends over time.
- Integrate coverage metrics into pull request checks to enforce minimum coverage thresholds.
- Centralize coverage data from multiple test runs or branches in a single dashboard.
- Generate coverage badges for README files to display test coverage status.
- Monitor coverage regressions across different Python versions or implementations.

## Worth the install?

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

Uploads Python test coverage reports to coveralls.io, integrating with coverage.py to publish coverage metrics online.

Yes. Coveralls is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It is the standard tool for publishing coverage to coveralls.io and integrates cleanly into existing coverage.py workflows. Install it if you use coveralls.io for coverage tracking.

## Install

pip install coveralls
uv add coveralls
poetry add coveralls

## Installing coveralls

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open and closed projects with minimal attribution requirements.

Quickstart:

pip install coveralls
coverage run --source=mypkg -m pytest tests/
coveralls

Requires Python 3.10 or later; requires coverage.py to be installed and a coverage data file to exist.

Verify before relying:

- Whether the package works with all CI/CD platforms or has platform-specific limitations.
- Whether authentication tokens or environment variables are required for coveralls.io integration.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

coverage upload to coveralls.io, python test coverage reporting, coverage.py integration, ci coverage publishing, coverage metrics online, test coverage tracking, coverage-tracking, ci-cd-integration

[View on SkillFed](https://skillfed.io/packages/coveralls) · [View on PyPI](https://pypi.org/project/coveralls/)