How to fix npm ERR! gyp ERR! find Python npm ERR! gyp ERR! stack Error: Could not find any Python installation to use in npm

npmINTERMEDIATEMEDIUMUpdated Dec 3, 2025· 144 views

The 'gyp ERR! find Python' error occurs when npm tries to build native C/C++ modules but cannot locate Python on your system. Node-gyp requires Python 3.6+ to compile packages like bcrypt, canvas, and sqlite3.

Quick fix

Fixes gyp ERR!

python3 --version
  1. Install Python 3.6 or later
  2. Configure npm to Use Python
  3. Verify Python version and retry
  4. For Docker/Alpine environments
npm — error
python3 --version
npm ERR! gyp ERR! find Python
npm ERR! gyp ERR! stack Error: Could not find any Python installation to use

What this error means

When you install a package that contains C/C++ source code, npm uses node-gyp to compile that code for your platform. Node-gyp depends on Python to generate and execute compilation commands. If Python is missing or npm cannot locate it, the build fails with this error.

Typical symptoms

  • npm install fails during package build phase with 'gyp ERR! find Python' message
  • Packages with native extensions (bcrypt, sqlite3, canvas) fail to install
  • Error appears after 'gyp verb check python' in the npm output
  • Works in Docker containers but fails locally due to missing Python
  • Installation succeeds on one machine but fails on another

Common causes

  1. Python is not installed on the system
  2. Python is installed but npm cannot find it in the PATH
  3. Python 2.7 or outdated Python 3 version is installed instead of Python 3.6+
  4. Multiple Python versions installed, and npm defaults to an incompatible one
  5. Docker Alpine image used without Python added

How to fix "npm ERR! gyp ERR! find Python npm ERR! gyp ERR! stack Error: Could not find any Python installation to use"

1Install Python 3.6 or later

First, check if Python is installed:

bash
python3 --version

On macOS:

bash
xcode-select --install
# or
brew install python3

On Linux (Ubuntu/Debian):

bash
sudo apt-get update
sudo apt-get install python3 make g++

On Windows:
Download Python from python.org and check 'Add Python to PATH' during installation.

Or use npm's built-in tool:

bash
npm install --global windows-build-tools
2Configure npm to Use Python

Tell npm where to find your Python installation:

bash
# macOS/Linux
npm config set python $(which python3)

# Windows
npm config set python C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python311\\python.exe
3Verify Python version and retry

Confirm Python is properly configured:

bash
python3 --version

Must be Python 3.6.0 or later. Then retry:

bash
npm install
4For Docker/Alpine environments

If using Alpine Linux image, add Python:

dockerfile
FROM node:16-alpine

RUN apk add --no-cache python3 py3-pip make g++
RUN npm config set python /usr/bin/python3

RUN npm install

Advanced notes

Node-gyp requires not just Python, but also a C/C++ compiler toolchain. On Windows, this means Visual Studio Build Tools. On macOS, the Xcode Command Line Tools. On Linux, gcc and g++ from build-essential. Modern node-gyp versions (v10+) support Python 3.12. Setting npm config is persistent across sessions.

Frequently asked questions

What does "gyp ERR!" mean?
When you install a package that contains C/C++ source code, npm uses node-gyp to compile that code for your platform. Node-gyp depends on Python to generate and execute compilation commands. If Python is missing or npm cannot locate it, the build fails with this error.
How do I fix "gyp ERR!"?
The 'gyp ERR! find Python' error occurs when npm tries to build native C/C++ modules but cannot locate Python on your system. Node-gyp requires Python 3.6+ to compile packages like bcrypt, canvas, and sqlite3.
What causes "gyp ERR!"?
Python is not installed on the system Python is installed but npm cannot find it in the PATH Python 2.7 or outdated Python 3 version is installed instead of Python 3.6+
Is the "gyp ERR!" error serious?
It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Official resources & further reading