zipapp convierte un directorio de código en un archivo ZIP que Python puede ejecutar. El formato .pyz resulta práctico para herramientas internas y aplicaciones puras con una entrada clara.

Empaqueta una aplicación

python -m zipapp mi_app -m "cli:main" -p "/usr/bin/env python3" -o mi_app.pyz
python mi_app.pyz --help

Define un punto de entrada estable

La opción -m crea __main__.py para importar y llamar a la función elegida. Si el directorio ya contiene ese archivo, conserva una sola estrategia. Excluye secretos, cachés y entornos virtuales.

Comprende los límites de distribución

El archivo no incorpora el intérprete ni resuelve automáticamente extensiones nativas. Las dependencias deben existir en el entorno o admitir su inclusión. Registra la versión mínima de Python y prueba cada sistema de destino.

Sigue aprendiendo

Consulta también creación de interfaces de línea de comandos. La documentación oficial de Python, consultada el 22 de julio de 2026, explica entry points, shebang y copia de archivos existentes.