Repolode
pyinstaller

pyinstaller/pyinstaller

Convierte programas Python en ejecutables independientes que funcionan sin tener instalado el intérprete de Python.

Alternativa open source a:py2exe

Estrellas
13,141
Forks
2,036
Issues abiertos
117
Último commit
hace 5 días

¿Qué es?

PyInstaller empaqueta una aplicación Python junto con sus dependencias y el propio intérprete de Python en una sola carpeta o en un único archivo ejecutable. El usuario final puede ejecutar la aplicación empaquetada sin instalar Python ni ningún módulo. Para ello, analiza el script, detecta todos los módulos y bibliotecas que importa y recopila esos archivos junto al intérprete.

La herramienta se prueba en Windows, macOS y GNU/Linux, y es compatible con Python 3.8 a 3.15. Se instala con pip y se ejecuta indicando un script principal. PyInstaller no es un compilador cruzado, así que una aplicación para un sistema operativo determinado debe compilarse en ese mismo sistema. Incluye compatibilidad de fábrica con paquetes importantes como numpy, PyQt5/6, PySide2/6, wxPython y matplotlib.

En macOS, funciona con la firma de código y puede crear aplicaciones universal2; en Windows, empaqueta las DLL de MS Visual C++.

Funciones clave

  • 01Empaqueta un script y sus dependencias en una sola carpeta o en un único archivo ejecutable.
  • 02Incluye el intérprete de Python para que no sea necesario instalar Python en los equipos de destino.
  • 03Es compatible con paquetes importantes de GUI y científicos, como PyQt, PySide, wxPython, numpy y matplotlib.
  • 04Funciona en Windows, macOS y GNU/Linux; admite firma de código y compilaciones universal2 en macOS.
  • 05Se instala con un único comando pip y se ejecuta desde la línea de comandos.

Casos de uso

  • Distribuir una herramienta Python de escritorio a usuarios que no tienen Python instalado.
  • Distribuir una aplicación de GUI creada con PyQt o wxPython como un único ejecutable listo para incluir en un instalador.
  • Entregar una utilidad de línea de comandos a colegas que usan Windows sin tener que gestionar entornos de Python.

Inicio rápido

  1. 1

    Instala PyInstaller con pip

    pip install pyinstaller
  2. 2

    Ejecuta PyInstaller con tu script principal

    pyinstaller /path/to/yourscript.py

Antes de usarlo

  • PyInstaller no es un compilador cruzado, por lo que debes compilar en el mismo sistema operativo que el de destino.
  • No se admiten Python 3.10.0 ni las versiones beta de Python 3.16.

En colecciones

Temas

Preguntas frecuentes

¿Qué es pyinstaller?
Convierte programas Python en ejecutables independientes que funcionan sin tener instalado el intérprete de Python. PyInstaller empaqueta una aplicación Python junto con sus dependencias y el propio intérprete de Python en una sola carpeta o en un único archivo ejecutable. El usuario final puede ejecutar la aplicación empaquetada sin instalar Python ni ningún módulo. Para ello, analiza el script, detecta todos los módulos y bibliotecas que importa y recopila esos archivos junto al intérprete.
¿pyinstaller es gratuito? ¿Qué licencia tiene?
pyinstaller es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿pyinstaller sigue mantenido?
Mantenimiento activo. El último commit de pyinstaller fue el 1 nov 2026.
¿Para qué puedo usar pyinstaller?
Distribuir una herramienta Python de escritorio a usuarios que no tienen Python instalado. Distribuir una aplicación de GUI creada con PyQt o wxPython como un único ejecutable listo para incluir en un instalador. Entregar una utilidad de línea de comandos a colegas que usan Windows sin tener que gestionar entornos de Python.
¿Cómo se instala pyinstaller?
Instala PyInstaller con pip: pip install pyinstaller Ejecuta PyInstaller con tu script principal: pyinstaller /path/to/yourscript.py
¿Dónde consigo pyinstaller?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/pyinstaller/pyinstaller

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados