Cómo compilar código Python en un ejecutable para Windows

Python es un lenguaje interpretado, por lo que "compilar" puede referirse a varias cosas: generación de bytecode, transformación a otro lenguaje o creación de un ejecutable independiente. Esta guía explica cómo convertir un script de Python en un archivo .exe para Windows usando py2exe, de modo que cualquier usuario de Windows pueda ejecutar el programa sin tener Python instalado.

Preparación

Paso 1

Crea tu programa en Python o cópialo al entorno de Windows.

Paso 2

Ejecuta el script en el intérprete de Python para verificar que no hay errores:

c:\Python> python miprograma.py

Paso 3

Descarga py2exe desde su sitio web oficial (versión compatible con tu versión de Python).

Paso 4

Guarda el instalador en disco.

Paso 5

Ejecuta el instalador y sigue los pasos. La instalación crea el módulo py2exe en el directorio distutils de tu instalación de Python.

Compilar el código Python

Paso 1

Crea un archivo llamado setup.py (o el nombre que prefieras) en el Bloc de notas o tu editor favorito. Este script indicará a py2exe qué programa convertir.

Paso 2

Añade el siguiente contenido al archivo:

from distutils.core import setup
import py2exe

setup(console=['miprograma.py'])

Donde miprograma.py es el nombre de tu script principal.

Paso 3

Ejecuta el script de configuración con py2exe:

c:\Python> python setup.py py2exe

Paso 4

Espera a que finalice la compilación. Py2exe mostrará las DLL de las que depende tu programa.

Paso 5

Al terminar, se creará un directorio llamado dist. Accede a él:

c:\Python> cd dist

Paso 6

Dentro encontrarás el ejecutable miprograma.exe. Prueba a ejecutarlo:

c:\Python\dist> miprograma.exe

Consejo

La página Compiling Python de Frederick Lundh ofrece una visión general de distintas técnicas y plataformas para compilar Python, incluyendo bytecode, Mac y Unix.

Advertencia

Algunos paquetes populares de Python para Windows (wxPython, NumPy, pyXML) pueden presentar problemas al compilar. Si tienes dificultades con módulos externos, consulta la web de py2exe. El proceso genera solo un .exe, no un instalador completo. Para crear un paquete instalable, usa herramientas como Inno Setup o MSI.