wheelgap tracker

psycopg2 wheel coverage

pip install psycopg2 on Python 3.14: wheels for the whole tree on 0 of the 6 platforms checked; builds from source on 6 platforms.

From the wheelgap 0.9.0 scan of 2026-11-16.

psycopg2 2.9.13

#390 by downloads · PyPI

Campaigns: On the to-do list of Windows on ARM wheels for the top 500.

Platform3.133.143.14t3.153.15t
Linux x86_64from sourcefrom sourcefrom sourcebuilds in 11 s, but importing it turns the GIL back onfrom sourcefrom source
Linux ARM64from sourcefrom sourcefrom sourcefrom sourcefrom source
Alpine x86_64from sourcefrom sourcefrom sourcefrom sourcefrom source
Alpine ARM64from sourcefrom sourcefails to build: needs a system libraryfrom sourcefrom sourcefrom source
macOS Apple siliconfrom sourcefrom sourcefrom sourcefrom sourcefrom source
macOS Intelfrom sourcefrom sourcefrom sourcefrom sourcefrom source
Windows x86_64wheelwheelfrom sourcewheelfrom source
Windows ARM64from sourcefrom sourcefails to build: compile errorfrom sourcefails to build: compile errorfrom sourcefrom source
Pyodide (browser)can't installcan't installn/an/an/a

Why? uvx wheelgap psycopg2==2.9.13 -p 3.15 -t all --explain

Install coverage with dependencies

Wheelgap checks the scanned release and its dependencies without extras. A target is marked “Not checked” if wheelgap could not resolve the full dependency tree or verify its packages.

TargetInstall result
3.14 linux-x86_64Builds from source
  • psycopg2==2.9.13 builds from source
3.14 linux-aarch64Builds from source
  • psycopg2==2.9.13 builds from source
3.14 musl-aarch64Builds from source
  • psycopg2==2.9.13 builds from source
3.14 macos-arm64Builds from source
  • psycopg2==2.9.13 builds from source
3.14 macos-x86_64Builds from source
  • psycopg2==2.9.13 builds from source
3.14 win-arm64Builds from source
  • psycopg2==2.9.13 builds from source
3.14t linux-x86_64Builds from source
  • psycopg2==2.9.13 builds from source
3.14t win-arm64Builds from source
  • psycopg2==2.9.13 builds from source

Build lab

A dated observation on GitHub's runners, not a promise about your machine: runners come with compilers and many system libraries preinstalled, so a build that works there can still need setup on your machine.

TargetFrom sourceDetails
3.14 musl-aarch64fails fails to build: needs a system libraryubuntu-24.04-arm, Python 3.14.10, 2026-11-15 · run
logError: pg_config executable not found. | pg_config is required to build psycopg2 from source. Please add the directory | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed to build 'psycopg2' when getting requirements to build wheel
3.14 win-arm64fails fails to build: compile errorwindows-11-arm, Python 3.14.10, 2026-11-15 · run
logxid_type.obj', '/OUT:build\\lib.win-arm64-cpython-314\\psycopg2\\_psycopg.cp314-win_arm64.pyd', '/IMPLIB:build\\temp.win-arm64-cpython-314\\Release\\psycopg\\_psycopg.cp314-win_arm64.lib']' returned non-zero exit status 1181. | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed building wheel for psycopg2 | ERROR: Failed to build one or more wheels
3.14t linux-x86_64GIL back on builds in 11 s, but importing it turns the GIL back onubuntu-24.04, Python 3.14.10t, 2026-11-15 · run
3.14t win-arm64fails fails to build: compile errorwindows-11-arm, Python 3.14.10t, 2026-11-15 · run
logtype.obj', '/OUT:build\\lib.win-arm64-cpython-314t\\psycopg2\\_psycopg.cp314t-win_arm64.pyd', '/IMPLIB:build\\temp.win-arm64-cpython-314t\\Release\\psycopg\\_psycopg.cp314t-win_arm64.lib']' returned non-zero exit status 1181. | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed building wheel for psycopg2 | ERROR: Failed to build one or more wheels

Notes

psycopg2 has wheels for Windows x86-64 only. psycopg2-binary has wheels for these platforms (not for free-threaded Python): pip install psycopg2-binary. The psycopg docs say it is meant for beginners and advise building psycopg2 from source for production. On Psycopg 3, pip install "psycopg[binary]" is the equivalent.

Alternative · Linux x86_64, Linux ARM64, Alpine x86_64, Alpine ARM64, macOS Intel, macOS Apple silicon · checked 2026-11-11

www.psycopg.org/docs/install.html#psycopg-vs-psycopg-binary · www.psycopg.org/psycopg3/docs/basic/install.html#binary-installation · pypi.org/project/psycopg2-binary/#files

Know a workaround, an alternative package, a conda-forge build or an upstream issue for psycopg2? Add a note (a pull request on GitHub; the format is in notes/README.md).

Badge for your README

[![wheels](https://img.shields.io/endpoint?url=https://wheelgap.github.io/tracker/badge/psycopg2.json)](https://wheelgap.github.io/tracker/#package=psycopg2)
[![wheels with dependencies](https://img.shields.io/endpoint?url=https://wheelgap.github.io/tracker/badge/psycopg2-tree.json)](https://wheelgap.github.io/tracker/p/psycopg2/)

Package JSON

All 5,000 packages