Instalar Python sin conexión

Esta guía muestra cómo instalar Python en un servidor mindzieStudio Enterprise que no tiene acceso a internet. Descarga todo en un equipo que sí tiene acceso a internet, copia una carpeta al servidor e instala desde esa carpeta. Ninguno de los pasos en el servidor requiere conexión a internet.

Prevea aproximadamente 30 minutos, más un reinicio del servidor al final.

Cuándo Necesita Python

Python solo es necesario para estas funciones:

Función	Qué hace
Enriquecimiento Python	Transformaciones de datos personalizadas escritas en Python
Acción Script Python	Integraciones automatizadas, exportaciones y notificaciones escritas en Python
Enriquecimiento AI Case Prediction	Entrena un modelo de predicción sobre sus casos y añade las predicciones a sus datos

Si no usa estas funciones, no necesita instalar Python.

Resumen

En un equipo con acceso a internet	En el servidor mindzieStudio
1. Crear la carpeta offline	6. Instalar Python para todos los usuarios
2. Descargar el instalador de Python	7. Comprobar la instalación de Python
3. Listar los paquetes que necesita	8. Instalar los paquetes desde la carpeta
4. Descargar los paquetes	9. Reiniciar el servidor
5. Copiar la carpeta al servidor	10. Comprobar Python en mindzieStudio

Qué Necesita

Un equipo con acceso a internet que tenga instalado Python. Puede ejecutar Windows, macOS o Linux, y cualquier versión reciente de Python. Solo se usa para descargar archivos.
Una forma de copiar una carpeta al servidor, como un USB, un recurso compartido de archivos, o el método aprobado por su organización para transferencia de archivos.
Acceso de administrador en el servidor mindzieStudio.
Al menos 500 MB de espacio libre en disco en el servidor.

Elija una Versión de Python

Use Python 3.13 (64-bit). Esta guía usa Python 3.13 en todos los ejemplos.

Use la Misma Versión de Python en Todo el Proceso

Los paquetes de Python están construidos para una versión específica de Python. Los paquetes que descargue en el Paso 4 deben coincidir con la versión de Python que instale en el servidor en el Paso 6. Si elige una versión diferente, cambie 3.13 en el comando del Paso 4 para que coincida.

Parte 1: En el Equipo con Acceso a Internet

Paso 1: Cree la Carpeta Offline

Cree una carpeta llamada python-offline con una carpeta packages dentro de ella. En PowerShell:

New-Item -ItemType Directory -Force -Path C:\python-offline\packages

Todo lo que descargue va en esta única carpeta.

Paso 2: Descargue el Instalador de Python

Vaya a la página Python Releases for Windows
Busque la última versión de Python 3.13
Haga clic en Windows installer (64-bit). El archivo se llama algo como python-3.13.15-amd64.exe
Guarde el archivo en C:\python-offline

Descargue el Instalador para Windows (64-bit)

No use el administrador de instalación de Python ni el paquete embebido para Windows. El administrador de instalación descarga Python durante la instalación, lo que falla en un servidor sin acceso a internet. El paquete embebido no incluye pip, que necesita para instalar paquetes.

Paso 3: Liste los Paquetes que Necesita

Cree un archivo de texto llamado requirements.txt en C:\python-offline, con un nombre de paquete por línea.

Siempre incluya pandas y numpy. Todos los enriquecimientos Python y acciones Script Python los necesitan. Incluya requests si sus scripts llaman servicios web o APIs de su empresa.

pandas
numpy
requests

Luego añada una línea para cada otro paquete que sus scripts usen. Mire las líneas import en su código Python. Algunos paquetes se instalan con un nombre diferente al que usa en import:

Su código dice	Añada esta línea a requirements.txt
`import openpyxl`	`openpyxl`
`import sklearn`	`scikit-learn`
`import dateutil`	`python-dateutil`
`import yaml`	`PyYAML`
`import pyodbc`	`pyodbc`
`import sqlalchemy`	`sqlalchemy`

¿Sus Scripts Ya Funcionan en Otra Máquina?

Si sus scripts Python ya funcionan correctamente en otro servidor o PC, copie sus versiones exactas de paquetes en lugar de escribir la lista manualmente. En esa máquina, ejecute:

python -m pip freeze > requirements.txt

Use ese archivo requirements.txt. Lista cada paquete instalado con su versión exacta, para que el servidor offline tenga las mismas versiones con las que se probaron sus scripts.

Paso 4: Descargue los Paquetes

Abra PowerShell y ejecute:

cd C:\python-offline
python -m pip download -r requirements.txt -d packages --only-binary=:all: --platform win_amd64 --python-version 3.13

Qué hace cada opción:

Opción	Propósito
`-r requirements.txt`	Descarga cada paquete de la lista, más todos los paquetes de los que dependen
`-d packages`	Guarda los archivos en la carpeta `packages`
`--platform win_amd64`	Descarga la versión para Windows 64-bit de cada paquete
`--python-version 3.13`	Descarga paquetes construidos para Python 3.13. Cámbielo si instala una versión diferente
`--only-binary=:all:`	Descarga solo paquetes listos para instalar, para no requerir compilación en el servidor

Gracias a estas opciones, el equipo donde descarga no necesita ejecutar Windows ni la misma versión de Python que el servidor.

El comando termina con Successfully downloaded seguido de los nombres de los paquetes. La carpeta packages ahora contiene archivos .whl como pandas-3.0.5-cp313-cp313-win_amd64.whl. La parte cp313 muestra que los archivos están hechos para Python 3.13.

Paso 5: Copie la Carpeta al Servidor

Copie la carpeta completa python-offline al servidor. Esta guía asume que la copia en el servidor es C:\python-offline.

La carpeta debe verse así:

C:\python-offline\
    python-3.13.15-amd64.exe
    requirements.txt
    packages\
        numpy-2.5.3-cp313-cp313-win_amd64.whl
        pandas-3.0.5-cp313-cp313-win_amd64.whl
        requests-2.34.2-py3-none-any.whl
        ... y más archivos .whl

Sus números de versión pueden variar.

Parte 2: En el Servidor mindzieStudio

Paso 6: Instale Python para Todos los Usuarios

mindzieStudio se ejecuta con una cuenta Windows propia, no con su cuenta. Solo puede usar Python que esté instalado para todos los usuarios y añadido al PATH del sistema.

Instale Python usando la ventana del instalador o un solo comando PowerShell.

Opción A: Ventana del instalador

Haga clic derecho en python-3.13.15-amd64.exe y seleccione Ejecutar como administrador
En la primera pantalla, marque Add python.exe to PATH, luego haga clic en Customize installation
En la pantalla de Optional Features, asegúrese de que pip esté marcado, luego haga clic en Next
En la pantalla de Advanced Options:
- Marque Install Python 3.13 for all users. La ubicación cambia a C:\Program Files\Python313
- Asegúrese de que Add Python to environment variables esté marcado
- Deje sin marcar todas las opciones que comienzan con Download, ya que requieren conexión a internet
Haga clic en Install, luego en Close cuando termine la instalación

Opción B: Comando PowerShell

Abra PowerShell como Administrador y ejecute el siguiente comando. Reemplace el nombre del archivo por el del instalador que descargó.

Start-Process -FilePath "C:\python-offline\python-3.13.15-amd64.exe" -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0" -Wait

InstallAllUsers=1 instala Python para todos los usuarios. PrependPath=1 agrega Python al PATH del sistema. El comando no muestra ventana y retorna cuando termina la instalación.

Paso 7: Compruebe la Instalación de Python

Cierre cualquier ventana abierta de PowerShell. Abra una ventana nueva de PowerShell como Administrador. Se requiere una ventana nueva para que tome el PATH actualizado.

Ejecute:

python --version
where.exe python

Salida esperada:

Python 3.13.15
C:\Program Files\Python313\python.exe

Python Debe Estar en Program Files

La primera ruta que muestra where.exe python debe apuntar a C:\Program Files\Python313\python.exe. Si apunta a una carpeta bajo C:\Users\, Python se instaló solo para su cuenta y mindzieStudio no puede usarlo. Desinstale esa copia desde Configuración > Aplicaciones, luego repita el Paso 6 y asegúrese de que Install Python 3.13 for all users esté marcado.

Paso 8: Instale los Paquetes desde la Carpeta

En la misma ventana PowerShell con derechos de administrador, ejecute:

python -m pip install --no-index --find-links C:\python-offline\packages -r C:\python-offline\requirements.txt

--no-index le dice a pip que no intente acceder a internet. --find-links le indica a pip que instale desde su carpeta packages.

El comando termina con Successfully installed seguido de los nombres de los paquetes.

Ejecute Este Comando como Administrador

Si PowerShell no está abierto como Administrador, pip muestra el mensaje Defaulting to user installation because normal site-packages is not writeable e instala los paquetes en su perfil personal, donde mindzieStudio no puede usarlos. Si ve este mensaje, abra PowerShell como Administrador y ejecute el comando nuevamente.

Confirme que los paquetes se cargan:

python -c "import pandas, numpy; print('pandas', pandas.__version__, 'numpy', numpy.__version__)"

Salida esperada (sus números de versión pueden variar):

pandas 3.0.5 numpy 2.5.3

Paso 9: Reinicie el Servidor

Reinicie el servidor Windows.

mindzieStudio busca Python al iniciar, y debe ver el PATH actualizado del sistema. Reiniciar el servidor es la forma confiable para asegurar que ambos ocurran. Reciclar el grupo de aplicaciones de mindzieStudio no es suficiente.

Paso 10: Compruebe Python en mindzieStudio

Verifique la herramienta Enterprise Configuration

Abra la herramienta Enterprise Configuration en el servidor
Vaya a la pestaña Server Setup
En la sección Python, el Status muestra Installed con la versión de Python, por ejemplo Installed (3.13.15)

Ejecute un enriquecimiento de prueba

Abra un proyecto en mindzieStudio y vaya a un cuaderno de enriquecimiento
Agregue un bloque de enriquecimiento Python
Verifique que Python Image esté configurado en LOCAL
Ingrese este código. Añada una línea import por cada otro paquete que instaló:

import pandas
import numpy

Calcule el enriquecimiento. Debe completarse sin error de Python.

Añadir Paquetes Después

Para añadir un paquete después de la instalación inicial, repita los mismos pasos solo con el nuevo paquete:

En el equipo con internet, añada el paquete a requirements.txt y ejecute de nuevo el comando del Paso 4 con el mismo --python-version
Copie la carpeta packages actualizada y el archivo requirements.txt al servidor
En el servidor, ejecute de nuevo el comando del Paso 8 en una ventana PowerShell como Administrador

No necesita reiniciar el servidor después de añadir paquetes.

Solución de Problemas

"No se encontró el ejecutable de Python 'python'"

Síntoma: Un enriquecimiento Python o una acción Script Python falla con:

Python executable 'python' was not found. Please ensure Python is installed and added to your system PATH environment variable.

Solución:

Repita el Paso 7. where.exe python debe apuntar a C:\Program Files\Python313\python.exe
Si Python se instaló solo para su cuenta, reinstálelo para todos (Paso 6)
Reinicie el servidor (Paso 9)

"ModuleNotFoundError: No module named ..."

Síntoma: Un enriquecimiento Python o una acción Script Python falla con ModuleNotFoundError: No module named 'openpyxl' (u otro paquete).

Solución:

En PowerShell con derechos de administrador, ejecute python -m pip show openpyxl (use el nombre del paquete del Paso 3)
Si pip indica Package(s) not found, el paquete no está instalado. Descárguelo (Paso 4), cópielo al servidor e instálelo (Paso 8)
Si la línea Location apunta a una carpeta bajo C:\Users\, el paquete se instaló sin derechos de administrador. Ejecute python -m pip uninstall openpyxl, luego repita el Paso 8 como Administrador

"No matching distribution found" al descargar

Síntoma: El comando del Paso 4 falla con ERROR: No matching distribution found for seguido de un nombre de paquete.

Solución:

Verifique la ortografía. Use el nombre del paquete, no el nombre del import (vea la tabla en Paso 3)
Si la línea incluye un número de versión, esa versión puede no estar disponible para su versión de Python. Elimínelo o elija una versión más reciente
Si su requirements.txt proviene de pip freeze, elimine cualquier línea que contenga @ file:. Esos paquetes se instalaron desde un archivo local y no pueden descargarse

"Could not find a version that satisfies the requirement" en el servidor

Síntoma: El comando del Paso 8 falla con Could not find a version that satisfies the requirement seguido de un nombre de paquete.

Solución:

La carpeta packages no contiene ese paquete, o los archivos se descargaron para otra versión de Python
Compare python --version en el servidor con el cp de los nombres de archivo. Para Python 3.13, los archivos deben incluir cp313 (los archivos terminados en py3-none-any.whl funcionan con cualquier versión)
Descargue nuevamente en el equipo con internet, usando --python-version igual al servidor, y copie de nuevo la carpeta packages

La imagen Python muestra "Python not configured"

Síntoma: Un enriquecimiento Python, una acción Script Python o un enriquecimiento AI Case Prediction muestran Python not configured en la configuración Python Image.

Solución: Los enriquecimientos y acciones creados antes de instalar Python conservan este valor. Cambie Python Image a LOCAL y calcule de nuevo.

Documentación Relacionada

Instalar Python - Instalar Python en un servidor con acceso a internet
Enriquecimiento Python - Transformaciones personalizadas de datos con Python
Acción Script Python - Ejecución automática de scripts Python
AI Case Prediction - Predicciones con aprendizaje automático
Requisitos Técnicos - Requisitos del servidor