Instalar y configurar Python para su uso en MATLAB

R2026b

Para llamar a Python^® desde MATLAB^®, debe disponer de una versión compatible de la implementación de referencia (CPython) instalada en su sistema. También debe configurar el entorno de Python para trabajar con MATLAB.

Comprobar una instalación existente de Python

Si ya tiene Python instalado, compruebe si MATLAB es compatible con su versión de Python en Versiones de Python compatibles con los productos de MATLAB por versión.

La instalación existente de Python también debe cumplir estos requisitos específicos de la plataforma:

• Windows^®: está instalada la versión de 64 bits de Python. No se admiten versiones de 32 bits.

• Windows: Python no se ha instalado desde Microsoft^® Store.

• Linux^® y Mac: si ha compilado Python a partir de la fuente, ha configurado la compilación con la opción --enable-shared. Para obtener más información, consulte Configurar Python en la documentación de Python.

• Mac: las instalaciones de MATLAB y Python tienen la misma arquitectura (procesador Apple silicon o Intel^®). Para obtener más información, consulte Cómo utilizar Python desde MATLAB en Mac con Apple Silicon.

Instalar Python

Si no tiene una versión compatible de Python instalada en el sistema, puede instalar una desde el panel Add-Ons de MATLAB o desde python.org.

Instalar Python desde el panel Add-Ons de MATLAB

Desde R2026b

Para instalar Python desde el panel Add-Ons de MATLAB, siga estos pasos:

1. Abra el panel Add-Ons haciendo clic en el icono de Add-Ons de la barra lateral izquierda del escritorio. Si el icono de Add-Ons no está presente, haga clic en el botón Open more panels y seleccione el panel Add-Ons.

2. Busque el texto MATLAB Support for Python.

3. Seleccione el complemento para la versión de Python que desea instalar.

4. Haga clic en el botón Install.

Ahora puede seleccionar esta versión instalada de Python como su entorno de Python usando pyenv o el panel External Languages. Para obtener más detalles, consulte Manage Python Environments Using External Languages Panel.

Instalar Python desde python.org

Para instalar Python desde python.org, siga estos pasos:

1. Vaya a https://www.python.org/downloads/ y desplácese a la sección Looking for a specific release.

2. Busque la versión que desea y haga clic en Download. Para obtener información sobre versiones compatibles, consulte Versiones de Python compatibles con los productos de MATLAB por versión.

3. Haga clic en el formato que desea instalar y siga las instrucciones online.

   • En Windows, seleccione el formato de 64 bits.

   • En Linux y Mac, si compila el ejecutable de Python a partir de la fuente, configure la compilación con la opción --enable-shared. Para obtener más información, consulte Configurar Python en la documentación de Python.

Configurar MATLAB para utilizar el entorno de Python

Puede configurar MATLAB para utilizar un entorno base (una instalación de Python para todo el sistema) o un entorno virtual (una carpeta de paquetes de Python aislada y específica del proyecto). Si aún no tiene un entorno virtual, puede crearlo desde el entorno base utilizando el panel External Languages (consulte Manage Python Environments Using External Languages Panel). Como alternativa, para crear un entorno virtual de forma programática, consulte el artículo de MATLAB Entornos virtuales de Python con MATLAB y el tutorial de Python Entornos virtuales y paquetes.

Para establecer el entorno de Python, utilice el panel External Languages, la función pyenv o la variable de entorno PYTHONHOME.

Seleccionar un entorno de Python con el panel External Languages

Desde R2026a

La forma más sencilla de configurar MATLAB para utilizar Python es seleccionar un entorno base o virtual usando el panel External Languages.

1. Para abrir la vista de Python en el panel External Languages, haga clic en el botón Open more panels en cualquier barra lateral y haga clic en External Languages. A continuación, seleccione la opción Python de la lista de lenguajes situada en la parte superior izquierda del panel.

2. Seleccione el entorno base o virtual de Python que prefiera haciendo clic con el botón secundario en un entorno de la sección All Python Environments y seleccionando Set as Selected Environment.

El entorno seleccionado aparece en la sección Selected Python Environment del panel External Languages.

Para obtener más información, consulte Manage Python Environments Using External Languages Panel.

Establecer la versión de Python en Windows

Si ha instalado Python con el instalador estándar, Python está registrado en el registro de Windows. Utilice el nombre-valor Version de pyenv para establecer qué versión de Python utilizar. Por ejemplo:

pyenv(Version="3.13");

Si ha realizado una instalación no estándar, como copiar archivos de Python en el ordenador sin ejecutar el instalador, establezca la versión de Python utilizando la ruta al archivo ejecutable de Python para el entorno base o virtual. Por ejemplo:

pyenv(Version="C:\Users\username\AppData\Local\Programs\Python\Python313\python.exe");

pyenv devuelve un objeto PythonEnvironment que contiene información sobre el entorno de Python actual.

  PythonEnvironment with properties:

          Version: "3.13"
       Executable: "C:\Users\username\AppData\Local\Programs\Python\Python313\python.exe"
          Library: "C:\Users\username\AppData\Local\Programs\Python\Python313\python313.dll"
             Home: "C:\Users\username\AppData\Local\Programs\Python\Python313"
           Status: NotLoaded
    ExecutionMode: InProcess

Establecer la versión de Python en Mac y Linux

Para establecer qué versión de Python usar en Mac y Linux, utilice el nombre-valor Version de pyenv para especificar la ruta completa al archivo ejecutable de Python para el entorno base o virtual. Por ejemplo:

pyenv(Version="/usr/bin/python3.13")

pyenv devuelve un objeto PythonEnvironment que contiene información sobre el entorno de Python actual.

  PythonEnvironment with properties:

          Version: "3.13"
       Executable: "/usr/bin/python3"
          Library: "libpython3.13.so.1.0"
             Home: "/usr"
           Status: NotLoaded
    ExecutionMode: InProcess

Utilizar una variable de entorno PYTHONHOME

Cuando sea posible, use el panel External Languages o pyenv para establecer la versión de Python. En casos en los que el panel o pyenv no se puedan utilizar, por ejemplo, cuando se ejecutan aplicaciones de MATLAB, una forma alternativa de establecer la versión es utilizar la variable de entorno PYTHONHOME. Si define la versión con pyenv y PYTHONHOME, las versiones deben ser la misma.

• Para ver el valor de la variable de entorno, en la línea de comandos de MATLAB, introduzca getenv("PYTHONHOME"). Para ver la versión establecida por pyenv, introduzca e = pyenv; e.Version

• Para establecer PYTHONHOME, consulte https://docs.python.org/3/using/cmdline.html#envvar-PYTHONHOME. Para obtener información sobre establecer variables de entorno, consulte la documentación de su sistema operativo. También puede establecer la variable utilizando setenv. Sin embargo, este ajuste solo se aplica a la sesión actual de MATLAB.

• Para eliminar PYTHONHOME de su sesión actual de MATLAB, introduzca unsetenv("PYTHONHOME").

Cambiar el modo de ejecución (opcional)

Después de seleccionar el entorno de Python, MATLAB no carga de inmediato el intérprete de Python. Se carga la primera vez que llama a una función de Python en MATLAB. Antes de la primera llamada, puede cambiar opcionalmente el modo de ejecución para Python. Puede ejecutar Python en el mismo proceso que MATLAB (modo InProcess) o en un proceso separado (modo OutOfProcess).

• De forma predeterminada, Python se ejecuta en modo InProcess. Este modo de ejecución tiene ventajas de rendimiento y se recomienda para ejecutar código Python existente.

• Si está desarrollando código Python activamente, establezca el modo de ejecución en OutOfProcess. Este modo protege la sesión de MATLAB frente a bloqueos en caso de código inestable y permite interrumpir la ejecución prolongada de código Python con Ctrl+C. Utilice también el modo OutOfProcess si necesita utilizar bibliotecas de terceros que entran en conflicto con MATLAB.

Para establecer el modo de ejecución, desde el panel External Languages, haga clic en el botón Settings y seleccione OutOfProcess. Como alternativa, en la línea de comandos de MATLAB, introduzca pyenv(ExecutionMode="OutOfProcess"). Para obtener más información, consulte Out-of-Process Execution of Python Functionality.

Confirmar que Python funciona con MATLAB

Para confirmar que Python funciona con MATLAB, cargue el intérprete de Python introduciendo una expresión de Python en MATLAB. Por ejemplo:

py.list

ans = 

  Python list with values:

    []

    Use string, double, datetime or cell function to convert to a MATLAB array.

Si recibe el mensaje de error Unable to resolve the name py.myfunc, donde myfunc es el nombre de la función, es posible que se haya encontrado con un problema en la instalación. Para obtener ayuda en la resolución de problemas, consulte Unable to Resolve the Name py.myfunc.

MATLAB accede a esta configuración cuando carga el intérprete de Python:

• Configuración de usuario para el entorno de Python, configurada mediante la función pyenv. Si la versión que especifica entra en conflicto con la versión especificada por la variable de entorno PYTHONHOME, borre la variable de entorno antes de llamar a pyenv. Para borrar la variable de entorno, en la línea de comandos de MATLAB, introduzca unsetenv("PYTHONHOME"). El valor establecido por pyenv se mantiene en las sesiones de MATLAB. Para obtener más información, consulte Establecer la versión de Python en Windows o Establecer la versión de Python en Mac y Linux.

• La variable de entorno PYTHONHOME, que especifica dónde encontrar las bibliotecas estándar de Python. MATLAB utiliza esta variable solo cuando el valor de pyenv.Status es NotLoaded. Para ver el valor de la variable en MATLAB, introduzca getenv("PYTHONHOME"). Para obtener más información, consulte Utilizar una variable de entorno PYTHONHOME.

• Variable de entorno PATH del sistema. Para ver la ruta del sistema en MATLAB, introduzca getenv("PATH").

• Registro de Windows.

Cambiar entornos de Python

Puede cambiar el entorno de Python que MATLAB utiliza a través del panel External Languages o llamando a pyenv. El proceso para cambiar entornos de Python depende del modo de ejecución.

• Si Python está cargado en modo InProcess, reinicie primero MATLAB. A continuación, use el panel External Languages o pyenv para cambiar el entorno de Python.

• Si Python está cargado en modo OutOfProcess, termine primero el proceso de Python llamando a terminate(pyenv). A continuación, use el panel External Languages o pyenv para cambiar el entorno de Python.

Para eliminar un entorno antiguo de Python del panel External Languages, haga clic con el botón secundario en el entorno de la lista All Python Environments y seleccione Remove Environment. Al eliminar un entorno, este no se borra del sistema. Puede añadirlo de nuevo más adelante. No puede eliminar de esta forma un entorno instalado desde un complemento MATLAB Support for Python. Para eliminar ese entorno, desinstale el paquete de soporte del panel Add-Ons y, después, actualice el panel External Languages utilizando el botón para actualizar.

Consulte también

Funciones

• pyenv

Temas

• Versiones de Python compatibles con los productos de MATLAB por versión
• Unable to Resolve the Name py.myfunc

Sitios web externos

• https://www.python.org/downloads/