Skip to content
PYGWALKER
FAQ
Errores de instalación

Preguntas frecuentes: Errores de instalación

ERROR: Falló la construcción del wheel para quickjs - error de Microsoft Visual Studio

Mensajes de error comunes

Los usuarios pueden encontrar uno o más de estos mensajes al instalar PyGWalker:

  • ERROR: Failed building wheel for quickjs
  • error: Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.42.34433\bin\HostX86\x64\cl.exe' failed with exit code 2
  • error D8024 : incompatible-pointer-types
  • [end of output] note: This error originates from a subprocess, and is likely not a problem with pip
  • ERROR: Could not build wheels for quickjs, which is required to install pyproject.toml-based projects
  • Building wheel for quickjs (setup.py) ... error
  • error: Microsoft C++ 14.0 or greater is required

Entornos afectados

  • Sistema operativo: Windows 10/11
  • Versiones de Python: Python 3.7, Python 3.8, Python 3.9
  • Método de instalación: pip install pygwalker
  • Común en: Instalaciones nuevas de Python, entornos virtuales sin herramientas de compilación C++

Soluciones rápidas

Solución 1: Instalar wheel precompilado (Recomendado - sin necesidad de compilación)

pip install --only-binary :all: pygwalker

Solución 2: Actualizar Python (Más efectivo)

# Actualiza a Python 3.9 o superior (se recomiendan 3.10, 3.11, 3.12)
# Descarga desde python.org, luego:
pip install --upgrade pip
pip install pygwalker

Solución 3: Instalar Microsoft C++ Build Tools (Para usuarios de Windows)

  1. Descarga Microsoft C++ Build Tools (opens in a new tab)
  2. Ejecuta el instalador y selecciona "Desktop development with C++"
  3. Reinicia tu consola/terminal
  4. Intenta instalar de nuevo:
pip install pygwalker

Soluciones alternativas

Usar Anaconda/Miniconda (maneja dependencias C automáticamente)

conda install -c conda-forge pygwalker

Para usuarios de WSL/Linux

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install python3-dev build-essential
pip install pygwalker
 
# CentOS/RHEL/Fedora
sudo yum install python3-devel gcc gcc-c++
pip install pygwalker

Instalar una versión específica (con wheels precompilados)

# Verifica versiones disponibles con wheels precompilados
pip install pygwalker==0.3.9  # o la versión estable más reciente

Solución con Docker (Entorno aislado)

FROM python:3.11-slim
RUN pip install pygwalker

Por qué ocurre este error

Este error ocurre porque:

  1. quickjs es una dependencia que requiere compilación C/C++
  2. Windows no incluye compiladores C++ por defecto
  3. Python 3.7 tiene problemas de compatibilidad con herramientas de compilación C++ más recientes
  4. El paquete intenta compilar desde el código fuente en lugar de usar wheels precompilados

Verificación después de la instalación

# Prueba si pygwalker está instalado correctamente
import pygwalker as pyg
print(pyg.__version__)

¿Sigues teniendo problemas?

Si ninguna de las soluciones anteriores funciona:

  1. Verifica tu versión de Python:

    python --version

    Asegúrate de usar Python 3.8 o superior

  2. Limpia la caché de pip:

    pip cache purge
pip install --no-cache-dir pygwalker

  3. Intenta instalar en un entorno virtual nuevo:

    python -m venv fresh_env
fresh_env\Scripts\activate  # En Windows
# source fresh_env/bin/activate  # En Linux/Mac
pip install --upgrade pip setuptools wheel
pip install pygwalker

  4. Reporta el problema:

Palabras clave para buscar

  • pygwalker error de instalación windows
  • failed building wheel for quickjs pygwalker
  • pygwalker microsoft visual studio error
  • pygwalker cl.exe failed with exit code 2
  • pygwalker incompatible-pointer-types error
  • pip install pygwalker error quickjs
  • pygwalker setup.py error
  • pygwalker C++ 14.0 required error
  • cannot install pygwalker windows
  • pygwalker build wheels failed
RecursosCómo utilizar PyGWalker con Streamlit