How to Install pyproj in Python
Python interface to PROJ (cartographic projections and coordinate transformations library)
pip install pyproj
What is pyproj?
Python interface to PROJ (cartographic projections and coordinate transformations library)
Python interface to PROJ (cartographic projections and coordinate transformations library).
Thanks goes to these wonderful people (emoji key):
Jeff Whitaker π β οΈ π» π‘ π€ π π¬ π§ π π Alan D. Snow π β οΈ π» π‘ π§ π π€ π π¬ π Micah Cochran π β οΈ π» π§ π π π¬ π Joris Van den Bossche π π» π€ π π¬ π β οΈ Chris Mayo β οΈ Charles Karney π» β οΈ Justin Dearing π Jos de Kloe π» β οΈ π George Ouzounoudis π» π€ David Hoese π π€ π¦ π β οΈ π» Mikhail Itkin π» Ryan May π» artttt π€ Filipe π π» π¦ π Heitor π Bas Couwenberg π» π¦ β οΈ Nick Eubank π» Michael Dunphy π Matthew Brett π π¦ Jakob de Maeyer π» The Gitter Badger π Bernhard M. Wiedemann π» Marco AurΓ©lio da Costa π» Christopher H. Barker π» Kristian Evers π¬ π€ π Even Rouault π¬ Christoph Gohlke π¦ π¬ π β οΈ Chris Willoughby π» Guillaume Lostis π Eduard Popov π Joe Ranalli π π» β οΈ Greg Berardinelli π π» π€ β οΈ Martin Raspaud π π» β οΈ π€ Mike Taves β οΈ David HaberthΓΌr π mmodenesi π π» β οΈ jacob-indigo π π» Poruri Sai Rahul β οΈ Yann-Sebastien Tremblay-Johnston π odidev π¦ Idan Miara π» π π‘ β οΈ Brendan Jurd π π¨ Bill Little π Gerrit Holl π Kirill Kouzoubov π» Dan Hemberger π π» Martin Fleischmann π π» β οΈ Matthias Meulien π» π Isaac Boates π» π β οΈ Kyle Penner π» π π paulcochrane π» π β οΈ π Antonio Ettorre π¦ DWesl π» VΓctor Molina GarcΓa π¦ Samuel Kogler π π» Alexander Shadchin π π» Greg Lucas π» π€ π§ Dan Mahr π» π β οΈ Romain Hugonnet π» π β οΈ Javier Jimenez Shaw π» π β οΈ Daniel McDonald π Cora Schneck π β οΈ zanejgr π Tomasz KΕoczko β οΈ Trinh Quoc Anh β οΈ necabo π¦
Quick Start
Minimal example to get started with pyproj:
import pyproj
print(pyproj.__version__)Installation
pip (standard)
pip install pyprojVirtual environment (recommended)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install pyprojpip3
pip3 install pyprojconda
conda install -c conda-forge pyprojPoetry
poetry add pyprojDependencies
Installing pyproj will also install these packages:
Verify the Installation
After installing, confirm the package is available:
python -c "import pyproj; print(pyproj.__version__)"If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.
Installation Errors
Common errors when installing pyproj with pip.
ModuleNotFoundError: No module named 'pyproj'
Cause: The package is not installed in the current Python environment.
Fix: Run pip install pyproj. If using a virtual environment, ensure it is activated first.
ModuleNotFoundError: No module named 'pyproj' (installed but still failing)
Cause: pip installed the package into a different Python than the one running your script.
Fix: Use python -m pip install pyproj to install into the interpreter you are running.
ImportError: cannot import name 'X' from 'pyproj'
Cause: The function or class does not exist in the installed version.
Fix: Check the version with pip show pyproj and upgrade with pip install --upgrade pyproj.
pip: command not found
Cause: pip is not in PATH or Python was not added to PATH during installation.
Fix: Try python -m pip install pyproj. On macOS/Linux try pip3.
PermissionError: [Errno 13] Permission denied
Cause: No write access to the system Python package directory.
Fix: Use a virtual environment, or add --user: pip install --user pyproj
SSL: CERTIFICATE_VERIFY_FAILED
Cause: pip cannot verify PyPI's SSL certificate β common behind corporate proxies.
Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org pyproj
MemoryError when loading data
Cause: Dataset is too large to fit in RAM.
Fix: Read in chunks, filter columns on load, or consider Polars/Dask for out-of-core processing.
Recent Releases
| Version | Released |
|---|---|
3.7.2 latest |
2025-08-14 |
3.7.2rc1 |
2025-08-12 |
3.7.2rc0 |
2025-08-10 |
3.7.1 |
2025-02-16 |
3.7.1rc0 |
2025-02-15 |
Manage pyproj
Upgrade to latest version
pip install --upgrade pyprojInstall a specific version
pip install pyproj==3.7.2Uninstall
pip uninstall pyprojCheck what is installed
pip show pyproj