Gestor moderno de paquetes y dependencias de Python que administra entornos virtuales, archivos de bloqueo y compilaciones según los metadatos de PEP 621 y PEP 517.
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
Ejecuta el script oficial de instalación indicado en el README
- 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
Un gestor de paquetes y proyectos de Python extremadamente rápido, escrito en Rust, que sustituye a pip, virtualenv, pyenv, pipx y más.
Una herramienta sencilla para compilar y publicar paquetes y módulos de Python puro en PyPI con una configuración mínima.
Gestor de dependencias para PHP que declara, instala y actualiza paquetes de proyectos desde Packagist.
Proxy y almacén de datos de código abierto y autohospedable que implementa el protocolo de descarga de módulos de Go para almacenar en caché dependencias.
Gestor de paquetes rápido y eficiente en disco para Node.js, con un almacén compartido direccionable por contenido, aislamiento estricto de dependencias y soporte para monorepos.