---
id: primer3-py
version: "2.3.0"
license: GPLv2
license_treatment: copyleft
maintenance: active
---

# primer3-py — Simple primer design and analysis

License: copyleft · Maintenance: active · Downloads: 435.4K/mo

## What it is and what it does

primer3-py is a Python wrapper around the Primer3 library, a widely-used tool for PCR primer design and oligo analysis. It provides direct access to thermodynamic calculations—such as melting temperature (Tm) and hairpin structure formation—through a simple Python API, avoiding the overhead of subprocess calls. The package includes bindings to Primer3's full design engine for automated primer selection pipelines.

The core appeal is speed: routine oligo analysis runs roughly 1000X faster than traditional subprocess-based wrappers. It supports modern Python versions (3.8–3.14) and is distributed as pre-compiled wheels for common platforms, minimizing installation friction. The package is actively maintained and documented, though users are directed to the upstream Primer3 team for design-engine-specific questions.

Use it for:

- Calculate melting temperature and secondary structure stability for DNA sequences in high-throughput screening or assay design workflows.
- Batch validate primer pairs for PCR experiments by computing thermodynamic properties without spawning external processes.
- Integrate primer design into automated laboratory pipelines using Primer3's design engine with Python parameter control.
- Analyze oligonucleotide libraries for off-target binding risk by computing hairpin formation across many sequences.
- Prototype and benchmark primer selection algorithms that depend on fast, repeated Tm and structure calculations.

## Worth the install?

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

primer3-py wraps the Primer3 library to provide fast oligo thermodynamic analysis (melting temperature, hairpin formation) and primer design through a Python API.

Yes, if you need fast oligo thermodynamic analysis or primer design in Python for research or open-source projects. The GPLv2 license is a hard blocker for proprietary software. Install friction is moderate due to compiled bindings, but pre-built wheels for common platforms and Python versions make setup straightforward. No known vulnerabilities and active maintenance support the choice.

## Install

pip install primer3-py
uv add primer3-py
poetry add primer3-py

## Installing primer3-py

Before you install: Medium install friction due to compiled C/Cython bindings, but wheels are pre-built for common platforms (macOS, Linux, Windows) across Python 3.8–3.14. Repository is actively maintained with recent commits and no archived status.

License in practice: GPLv2 copyleft license requires derivative works and distributions to be licensed under GPLv2 and source made available; suitable for research and open-source projects but may conflict with proprietary software licensing.

Quickstart:

pip install primer3-py
import primer3
tm = primer3.calc_tm('GTAAAACGACGGCCAGT')
print(tm)  # 49.16808228911765
result = primer3.calc_hairpin('CCCCCATCCGATCAGGGGG')
print(result.tm)  # 34.15

Requires Python 3.8 or later; compiled wheels available for macOS, Linux, and Windows but may require a C compiler on unsupported platforms.

Verify before relying:

- Whether the Primer3 design engine bindings are production-ready or primarily for research use given the disclaimer about contacting the Primer3 dev team for support.
- Performance characteristics and memory overhead for large-scale batch oligo analysis compared to the ~1000X speedup claim over subprocess wrappers.

## Package facts

- License: GPLv2 (copyleft)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 435.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

primer design python, oligo analysis thermodynamics, melting temperature calculation, primer3 wrapper, dna primer design, hairpin structure prediction, pcr primer selection, bioinformatics, pcr-design, dna-analysis

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