psycopg2 2.9.13
#390 by downloads · PyPI
Campaigns: On the to-do list of Windows on ARM wheels for the top 500.
| Platform | 3.13 | 3.14 | 3.14t | 3.15 | 3.15t |
|---|---|---|---|---|---|
| Linux x86_64 | from source | from source | from sourcebuilds in 11 s, but importing it turns the GIL back on | from source | from source |
| Linux ARM64 | from source | from source | from source | from source | from source |
| Alpine x86_64 | from source | from source | from source | from source | from source |
| Alpine ARM64 | from source | from sourcefails to build: needs a system library | from source | from source | from source |
| macOS Apple silicon | from source | from source | from source | from source | from source |
| macOS Intel | from source | from source | from source | from source | from source |
| Windows x86_64 | wheel | wheel | from source | wheel | from source |
| Windows ARM64 | from source | from sourcefails to build: compile error | from sourcefails to build: compile error | from source | from source |
| Pyodide (browser) | can't install | can't install | n/a | n/a | n/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.
| Target | Install result |
|---|---|
| 3.14 linux-x86_64 | Builds from source
|
| 3.14 linux-aarch64 | Builds from source
|
| 3.14 musl-aarch64 | Builds from source
|
| 3.14 macos-arm64 | Builds from source
|
| 3.14 macos-x86_64 | Builds from source
|
| 3.14 win-arm64 | Builds from source
|
| 3.14t linux-x86_64 | Builds from source
|
| 3.14t win-arm64 | 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.
| Target | From source | Details |
|---|---|---|
| 3.14 musl-aarch64 | fails fails to build: needs a system library | ubuntu-24.04-arm, Python 3.14.10, 2026-11-15 · runlogError: 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-arm64 | fails fails to build: compile error | windows-11-arm, Python 3.14.10, 2026-11-15 · runlogxid_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_64 | GIL back on builds in 11 s, but importing it turns the GIL back on | ubuntu-24.04, Python 3.14.10t, 2026-11-15 · run |
| 3.14t win-arm64 | fails fails to build: compile error | windows-11-arm, Python 3.14.10t, 2026-11-15 · runlogtype.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
[](https://wheelgap.github.io/tracker/#package=psycopg2)[](https://wheelgap.github.io/tracker/p/psycopg2/)