testcontainers-core

Testcontainers is a Python library that providing a friendly API to run Docker container. It is designed to create runtime environment to use during your automatic tests.

No known security advisories. The current version has no OSV.dev malware reports and no critical or high-severity vulnerabilities.

testcontainers-core has 299K monthly downloads and 2K GitHub stars. Version 0.0.1rc1 supports Python 3.7+, first published in 2023.

It is actively maintained, last released in Jan 2023.

It is built on top of docker and wrapt. It is used by 22 tracked packages, including testcontainers-postgres, testcontainers-redis and testcontainers-mysql.

GitHub topics include testing, testcontainers and selenium.

Shared Repository

This package shares its GitHub repository (testcontainers/testcontainers-python) with 20 other packages. Stars, forks, and other GitHub metrics reflect the entire repository.

testcontainers (27.6M) testcontainers-postgres (73.4K) testcontainers-redis (32.8K) testcontainers-mysql (31.5K) testcontainers-mongodb (20.7K) testcontainers-neo4j (17.7K) testcontainers-kafka (11.9K) testcontainers-localstack (7.4K) testcontainers-mssql (6.1K) testcontainers-clickhouse (4.4K) +10 more

Downloads

Day

8.9K

Week

68.5K

Month

299.2K

Stars

2.2K

Forks

Issues

Version

Package Insights

Package Risks

No releases in 1266 days despite active commits

click for breakdown

Actively Maintained

click for breakdown

Community Favorite

click for breakdown

click for breakdown

Score breakdown - each component scores 0-100, weighted by percentage

Maintenance

50

Popularity

72

Adoption

64

Community

80

Provenance

0

How the maintenance status was determined

Last commit

10 days ago

Monthly downloads

299,155

• Active

Activity within 30 days

Stable

Activity within 31-180 days

Minimal

Activity within 181-365 days, or no activity data

At Risk

No activity for > 365 days, but > 10,000 monthly downloads

Archived

Repository flagged as archived on GitHub

How the popularity category was determined

Monthly downloads

299,155

Stars

2,244

Stars per 1k downloads

7.50

Industry Standard

> 10,000,000 monthly downloads

Hidden Gem

< 0.5 stars per 1k downloads and > 100,000 monthly downloads

• Community Favorite

> 5 stars per 1k downloads

Rising Star

Balanced ratio of stars to downloads

Unknown

Fewer than 1,000 monthly downloads, or no star data

How download momentum is calculated

Week daily avg

9,788

Month daily avg

9,972

Momentum

-1.8%

((week_daily_avg - month_daily_avg) / month_daily_avg) * 100

click for breakdown

click for breakdown

Release Cadence

click for breakdown

Contributor Risk

click for breakdown

Python version support tiers

requires_python

>=3.7

Cutting Edge

Minimum supported version is 3.12 or newer

Modern

Minimum supported version is 3.9, 3.10, or 3.11

• Legacy

Supports 3.8 or older (or Python 2)

Unknown

No requires_python specified or unparseable

License categories

License

Not specified

Permissive

MIT, Apache, BSD, ISC, Unlicense, CC0, etc.

Copyleft

GPL, LGPL, AGPL, MPL, EPL, etc.

Proprietary

Commercial, all rights reserved, custom EULAs

• Unknown

No license specified, or none of the above match

Package does not declare a license.

How the release cadence was determined

Last release

1277 days ago

Total releases

1

Releases/year

0.3

Rapid

Last release within 365 days and > 12 releases/year

Regular

Last release within 365 days

Slow

Last release 366-730 days ago

• Stalled

Last release > 730 days ago, or no releases

Unknown

No usable release date available

How contributor risk was determined

Contributors

185

Monthly downloads

299,155

High Load

≤ 2 contributors and ≥ 50,000 monthly downloads

Moderate Load

< 10 contributors and ≥ 500,000 monthly downloads

Low Load

< 25 contributors and ≥ 5,000,000 monthly downloads, or sole maintainer with ≥ 10,000 monthly downloads

• Balanced

Enough contributors for the package's popularity

Unknown

No contributor data available

Engagement

81

Issue Burden

58.4

per 1k stars

Discussions

3.6

per 1k stars

Fork Ratio

49.3%

contrib / forks

Stale Release

1266d

PR Velocity

Quiet

Weekly Downloads

Last 7 days

68,517

Last 30 days

296,434

Peak day (2026-04-08)

30,907

2026-03-26 – 2026-07-03. Enable JavaScript for the interactive chart.

GitHub Stars

Current

2,244

Earliest (2026-01-14)

2,100

Change

+144

2026-01-14 – 2026-07-05. Enable JavaScript for the interactive chart.

Not all downloads include detailed metadata. Breakdowns reflect the subset that does.

Downloads by OS

Linux 5.7K

Windows 10

macOS 1

Python Versions

3.11

83.8% 4.6K

3.12

13.6% 751

3.13

2.2% 119

3.10

0.3% 18

3.7

0.1% 4

Top Countries

1.

US

3.3K

2.

DE

1.0K

3.

IN

456

4.

FR

439

5.

IE

378

6.

FI

67

7.

BR

25

8.

NL

15

9.

AU

7

10.

LV

6

Dependencies

2

docker >=4.0.0
wrapt

Used By

22

GitHub Topics

Tags from the package's GitHub repository describing what it does.

Python Python3 Testing Testcontainers Selenium Database

Package Information

License

Unknown

First Release

January 6, 2023

Last Release

3 years ago

Last Commit

1 week ago

Latest Version

0.0.1rc1

Total Releases

1

Contributors

185

Open PRs

39

Archived

No

Wheels

py3

Tracking Since

January 6, 2026

Data Updated

July 5, 2026

Data Freshness

Fresh

Links

testcontainers/testcontainers-python