Repolode
python-poetry

python-poetry/poetry

Herramienta de empaquetado y gestión de dependencias para Python que declara, bloquea e instala las dependencias del proyecto desde un único archivo pyproject.toml.

Alternativa open source a:pip

Estrellas
34,368
Forks
2,577
Issues abiertos
622
Último commit
hace 4 días

¿Qué es?

Poetry ayuda a los desarrolladores de Python a declarar, gestionar e instalar las dependencias de sus proyectos para que se pueda reproducir el mismo entorno en otras máquinas. Sustituye la combinación habitual de setup.py, requirements.txt, setup.cfg, MANIFEST.in y Pipfile por un único archivo pyproject.toml que describe los metadatos del proyecto, las dependencias, los scripts y la configuración de compilación.

Las dependencias se pueden organizar en grupos (por ejemplo, dev, docs o lint) e instalar de forma selectiva; también se pueden habilitar extras opcionales durante la instalación. Las dependencias pueden provenir de PyPI, repositorios de Git o rutas locales, y las restricciones de versiones usan una sintaxis similar a semver. Poetry también funciona como backend de compilación mediante poetry-core, por lo que la misma herramienta puede empaquetar un proyecto para su publicación.

Funciones clave

  • 01Declara los metadatos y las dependencias del proyecto en un único archivo pyproject.toml.
  • 02Gestiona grupos de dependencias y extras opcionales que se pueden instalar cuando se necesiten.
  • 03Admite dependencias de PyPI, repositorios de Git y rutas locales.
  • 04Funciona como backend de compilación PEP 517 para empaquetar y publicar proyectos.

Casos de uso

  • Iniciar una nueva biblioteca o aplicación de Python con una estructura de proyecto estándar.
  • Mantener versiones reproducibles de las dependencias en los entornos de desarrollo y CI.
  • Publicar un paquete de Python en PyPI usando la misma configuración del proyecto.

Inicio rápido

  1. 1

    Ejecuta el script oficial de instalación indicado en el README

  2. 2

    Declara las dependencias del proyecto en pyproject.toml

Temas

Preguntas frecuentes

¿Qué es poetry?
Herramienta de empaquetado y gestión de dependencias para Python que declara, bloquea e instala las dependencias del proyecto desde un único archivo pyproject.toml. Poetry ayuda a los desarrolladores de Python a declarar, gestionar e instalar las dependencias de sus proyectos para que se pueda reproducir el mismo entorno en otras máquinas. Sustituye la combinación habitual de setup.py, requirements.txt, setup.cfg, MANIFEST.in y Pipfile por un único archivo pyproject.toml que describe los metadatos del proyecto, las dependencias, los scripts y la configuración de compilación.
¿poetry es gratuito? ¿Qué licencia tiene?
poetry es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿poetry sigue mantenido?
Mantenimiento activo. El último commit de poetry fue el 2 nov 2026.
¿Para qué puedo usar poetry?
Iniciar una nueva biblioteca o aplicación de Python con una estructura de proyecto estándar. Mantener versiones reproducibles de las dependencias en los entornos de desarrollo y CI. Publicar un paquete de Python en PyPI usando la misma configuración del proyecto.
¿Cómo se instala poetry?
Ejecuta el script oficial de instalación indicado en el README Declara las dependencias del proyecto en pyproject.toml
¿Dónde consigo poetry?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/python-poetry/poetry

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

Proyectos relacionados