Introducción
Python es un lenguaje multiplataforma muy poderoso. Sirve para miles de cosas, pero hay algo que dificulta su “distribución” a los usuarios finales.
Es decir, no podemos mandarle un script con extensión .py a un cliente y decirle que instale Python, lo ponga en la variable PATH y lo ejecute desde la terminal.
Además… ¿qué pasa si nuestro script tiene dependencias? o si son muchos scripts, o cosas de esas.
Debido a esto, necesitamos algo así como un creador de ejecutables de Python. Una cosa que empaque todo en un archivo .exe (o al menos en un .zip) y que, sin necesidad de que en la máquina del usuario exista Python, se pueda ejecutar.
Justamente hoy venimos a hablar de eso: cómo crear un ejecutable de archivos de Python, utilizando PyInstaller.
Actualización
He creado la parte 2 de este tutorial en donde se ve cómo agregar assets al ejecutable. De esta manera puedes agregar imágenes, canciones o texto, cualquier archivo.
Requisitos para crear ejecutable de Python
Contar con Python (obviamente) y pip. Aquí un tutorial: instalar python.
Instalar PyInstaller
Si ya tenemos instalado pip, ejecutamos lo siguiente en nuestra consola:
pip install pyinstaller
Esperamos un rato a que se termine de instalar, y listo. Aquí dejo un enlace a la documentación oficial por si tienes problemas.
En mi caso, salió como se ve en la imagen. A todos nos saldrán diferentes cosas, tal vez; pero lo importante es que al final diga Successfully.
¡Listos para empaquetar!
¿Cómo funciona el empaquetamiento?
Yo tampoco lo sé, pero a grandes rasgos, pone el intérprete de Python y nuestros scripts en una carpeta (o archivo, como veremos más abajo) que puede ser distribuida a diferentes usuarios.
Explicaré dos opciones. Una para generar todo en una carpeta; y dentro de esa carpeta poner un .exe (que después podemos comprimir), y otra para (la que más me gusta) generar un archivo.exe independiente.
Nota: esto no protege nuestro código. Es decir, cualquiera podrá (no sé cómo, pero se puede) modificarlo.
Código de ejemplo
Vamos a utilizar el código en donde tomamos una foto de la webcam. Si no tienes webcam, o sólo quieres probar, haz un hola mundo y listo.
Generar una carpeta con ejecutable
Primero veremos cómo generar una carpeta que tendrá todo lo necesario para ejecutar nuestro código. Comencemos creando una carpeta nueva, en donde residirá nuestro código; esto lo hago más que nada para organizar las cosas, pero no es necesario crear nada.
En esa carpeta pondré el único script que se encarga del funcionamiento. Hasta el momento, se ve así:
Ahora navegaré hasta ahí desde la terminal, y escribiré lo siguiente:
pyinstaller foto_camara_nombres.py
Simplemente estoy llamando al ejecutable pyinstaller, y le paso como argumento el nombre de mi script.
Esto puede tardar un poco, e incluso mostrar advertencias. Pero tranquilos, que las advertencias advertencias son. Mientras no genere un error, todo va bien. Me parece que el tiempo que tarda depende de las dependencias.
Como lo dije, tarda pero al final funciona. Miraré ahora la carpeta en donde ejecuté este comando… ahora tiene otros directorios, pero lo que nos importa es el que dice dist. Dentro de él, está todo lo que necesitamos para ejecutar nuestra app.
Ahora podemos comprimir toda esa carpeta, mandarla a nuestro cliente y decirle que ejecute el archivo .exe. O crear un instalador que copie todo eso y genere un acceso directo. Notar por favor que todos los demás archivos son necesarios, no sólo el .exe.
Si queremos todo en un archivo .exe, sigamos leyendo.
Generar un sólo archivo ejecutable
La mayoría queremos esto. Empaquetar todo lo necesario en un archivo ejecutable. Doble click y listo. Para ello, es casi como hace un momento, pero pasamos la opción --onefile. Así:
pyinstaller --onefile foto_camara_nombres.py
Con eso tenemos. Es un buen momento para mencionar que al abrir la aplicación, se tardará un poco más. Yo lo probé y no noté ninguna diferencia significante, pero sería de probar por nosotros mismos.
Ahora en dist sólo está el archivo binario. Y ese ya trae todo para ejecutar Python sin tenerlo instalado.
Probar ejecutable
Si tienes dudas, o si no crees que esto funcione, aquí dejo el ejecutable que yo mismo generé. Puedes confiar en él; lo que hace es tomar una foto de la webcam y guardarla en tu disco duro, sólo eso.
En fin, descárgalo bajo tu responsabilidad. Lo dejo alojado en Mega porque WordPress no me permite cargar archivos de ese tipo.
Conclusión
Esto nos brinda la posibilidad de generar ejecutables que podemos distribuir fácilmente por todo el mundo. Si lo combinamos con Cython, creo que ahora sí podremos proteger el código para que no sea modificado.
Este “generador” funciona en cualquier plataforma. Es decir, si queremos, también podemos portarlo para Linux o Mac; eso sí, necesitamos compilarlo en la misma plataforma que deseamos distribuirlo. En pocas palabras, si lo quieres en Linux, compila en Linux, si lo quieres para Mac, en Mac. Y si lo quieres en Windows, pues ya sabes, ¿no?
Dejo aquí la documentación oficial a PyInstaller. Eso es todo.
Hola, como haria para agregar al ejecutable la base de datos
Hola. Gracias por sus comentarios. Si tiene alguna consulta o duda, solicitud de creación de un programa, solicitud de vídeo o solicitud de cambio de software estoy para servirle en https://parzibyte.me/#contacto
Saludos!
Hola, estoy haciendo código basado en las librerías PDF2IMAGE y PYTESSERACT para leer desde remitos escaneados en PDF el N° de ese remito y renombrar cada archivo con ese N° para identificarlos y almacenarlos en un servidor. Lo hice funcionar en mi PC donde instale dichas librerías pero al convertirlo en .EXE (en carpeta o en un solo archivo) con PYINSTALLER y tratar de ejecutarlo en la PC de mi trabajo (sin permisos para instalar las librerías) no funciona. ¿No se supone que al crearse el .EXE se incluyen todos los archivos para ejecutarlo en cualquier PC? Desde ya muchas gracias!
Hola gracias por tu explicación…en mi caso quiero hacer ejecutable mi codigo, es un buscador en tkinter que se conecta a un txt(todo dentro de la misma carpeta), hice todos los pasos pero cuando abro el .exe me sale el siguiente nameError: name is ‘true is not defined’ podrias ayudarme?
Hola, buen día. Con gusto la atiendo en https://parzibyte.me#contacto
Saludos 🙂
No comprendo como un codigo corto ejecutable pesa 30 mb
No es tanto el código, sino los ejecutables y librerías de Python.
Saludos
hola que software puedo usar para licenciar el exe que qse genera
Hola. No conozco ningún software para agregar una licencia; la lógica debería ser implementada en Python o algo así, usando sus propios métodos. Por otro lado, recuerde que el código puede ser decompilado así que no tendría mucho sentido poner licencia si el usuario final podrá modificar el código.
Hola, buenas.
Muy bueno tu tutorial, con programas chicos me funciona bien pero tengo uno que usa pyqt5 para generar una interfaz con botones y esas cosas. El tema es que cuando ejecuto el comando que explicas acá genera bien el .exe pero al darle doble click no me carga nada y desconozco si faltará hacer otro paso.
Gracias
Me parece que específicamente para PyQt hay otro proceso que se indica en la página oficial, ya que pyinstaller no funciona con la librería. Espero tener tiempo de traer un tutorial sobre ello muy pronto
Me está pasando lo mismo pero con otras librerías
Pingback: Pyinstaller parte 2: agregar assets, imágenes y archivos a ejecutable de Python - Parzibyte's blog
Me ha funcionado, pero necesito incluir imágenes y dependencias de python que utilizo en el script como “pyserial”, ¿Se podría conseguir?
Saludos.
Hola, he creado otro tutorial para lo de los assets: Agregar assets con PyInstaller
Sobre las dependencias, me parece que son empaquetadas junto con los scripts.