Errores al instalar Python, pip y herramientas de IA en Windows

«python» no se reconoce como un comando interno o externo

Por qué pasa

Python no está instalado o no se añadió al PATH, la lista de carpetas donde Windows busca los programas. En Windows, escribir «python» puede abrir además la Microsoft Store en lugar de Python.

Cómo se arregla

1. Descarga Python desde python.org y, en la primera pantalla del instalador, marca la casilla para añadirlo al PATH.
2. Cierra todas las ventanas de terminal y abre una nueva.
3. Prueba python --version. Si no va, prueba py --version, el lanzador que instala python.org.
4. Si se abre la Microsoft Store, busca «alias de ejecución de aplicaciones» en Configuración y desactiva los de python.exe y python3.exe.

«pip» no se reconoce o instala los paquetes en otro Python

Por qué pasa

Si tienes varias versiones de Python, el comando pip puede pertenecer a una distinta de la que ejecuta tus scripts, o no estar en el PATH.

Cómo se arregla

1. Usa siempre pip a través del Python que vas a usar: python -m pip install nombre-del-paquete.
2. Comprueba a qué Python pertenece con python -m pip --version: la ruta del final debe ser la de tu Python.
3. Si tienes varias versiones, elige una con py -3.12 -m pip install ... (cambia 3.12 por la tuya).

He instalado el paquete y el script dice ModuleNotFoundError

Por qué pasa

Lo instalaste en un Python o en un entorno distinto del que ejecuta el script.

Cómo se arregla

1. En la carpeta del proyecto, crea un entorno virtual: python -m venv .venv.
2. Actívalo: .venv\Scripts\Activate.ps1 en PowerShell.
3. Instala ahí: python -m pip install nombre-del-paquete.
4. Ejecuta el script con ese mismo Python, con el entorno activado.

pip install falla con «Microsoft Visual C++ 14.0 or greater is required»

Por qué pasa

El paquete no tiene una versión ya compilada para tu versión de Python y pip intenta compilarlo, para lo que necesita las herramientas de compilación de Microsoft. Pasa a menudo con la versión de Python más reciente.

Cómo se arregla

1. Mira en la página del paquete (pypi.org) qué versiones de Python admite.
2. Si la tuya es demasiado nueva, instala una versión anterior de Python y crea el entorno con ella.
3. Actualiza pip antes de reintentar: python -m pip install --upgrade pip.
4. Solo si el paquete exige compilarse, instala las Build Tools de Visual Studio desde la web de Microsoft.

PowerShell: la ejecución de scripts está deshabilitada en este sistema

Por qué pasa

Windows trae una política que impide ejecutar scripts de PowerShell por seguridad. Muchas guías de IA usan uno para instalar o activar un entorno.

Cómo se arregla

1. Lee el script antes de ejecutarlo y comprueba que viene de la web oficial del programa.
2. Para permitir scripts locales y firmados solo en tu usuario: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
3. Si solo quieres ejecutar uno, sin cambiar nada: powershell -ExecutionPolicy Bypass -File .\script.ps1.
4. Si el script viene de internet y sigue bloqueado, desbloquéalo tras revisarlo: Unblock-File .\script.ps1.

curl en PowerShell da error al mandar JSON a una API

Por qué pasa

En Windows PowerShell, curl no es el programa curl: es otro nombre de Invoke-WebRequest, que no entiende las mismas opciones y se lleva mal con las comillas del JSON.

Cómo se arregla

1. Usa Invoke-RestMethod y construye el cuerpo con ConvertTo-Json.
2. Ejemplo: $cuerpo = @{ model = "modelo"; prompt = "Hola" } | ConvertTo-Json.
3. Y después: Invoke-RestMethod -Uri http://127.0.0.1:11434/api/generate -Method Post -ContentType "application/json" -Body $cuerpo.
4. Si prefieres el curl de verdad, escribe curl.exe.

Guía: Ollama devuelve una respuesta vacía

He puesto una variable de entorno y el programa no la ve

Por qué pasa

Las variables de entorno se leen al abrir cada programa. Las ventanas y programas que ya estaban abiertos no ven las nuevas. Algunos programas, como Ollama, siguen en la bandeja del sistema aunque cierres su ventana.

Cómo se arregla

1. Cierra todas las terminales y el programa, incluido su icono de la bandeja.
2. Abre una terminal nueva y comprueba la variable: $env:NOMBRE_DE_LA_VARIABLE.
3. Vuelve a abrir el programa desde esa terminal o desde el menú Inicio.

Guía: OpenCode con Ollama no funciona

El programa de IA falla y mi usuario de Windows tiene tildes, eñes o espacios

Por qué pasa

Algunos programas no manejan bien las rutas con caracteres que no son ASCII. Si tu carpeta de usuario se llama «José» o «Muñoz», pueden fallar al cargar archivos de ahí.

Cómo se arregla

1. Crea una carpeta con un nombre simple, como C:\ia.
2. Mira si el programa permite elegir dónde guarda sus datos. En Ollama es la variable OLLAMA_MODELS: [Environment]::SetEnvironmentVariable("OLLAMA_MODELS", "C:\ollama-modelos", "User").
3. Reinicia el programa y vuelve a descargar o mover los archivos a la carpeta nueva.

Guía: Ollama error 500 «unable to load model»

Windows SmartScreen o el antivirus bloquean el instalador del programa de IA

Por qué pasa

Windows desconfía de los programas nuevos o poco descargados. A veces es un falso aviso; otras, el archivo no viene de donde crees.

Cómo se arregla

1. Descarga el programa solo desde su web oficial o su página oficial de GitHub, nunca de un enlace de un vídeo o un foro.
2. Clic derecho en el archivo, Propiedades: mira en Firmas digitales quién lo firma.
3. Si el origen es el oficial, en el aviso de SmartScreen pulsa «Más información» y «Ejecutar de todas formas».
4. Si el antivirus lo detecta como malicioso, no lo ejecutes y descárgalo de nuevo desde la web oficial.