Instalar Poetry con Pip: guía práctica para desarrolladores
0) Requisitos rápidos comprueba Python asegurándote de tener una versión soportada ejecuta python3 --version Poetry requiere Python moderno generalmente 3.9 o superior
1) Instalar Poetry dos opciones seguras Opción A recomendada usa pipx para aislar la herramienta y facilitar actualizaciones ejecuta python -m pip install --user pipx python -m pipx ensurepath reinicia la shell si se indica luego pipx install poetry pipx crea entornos aislados para cada herramienta lo que es ideal para utilidades como Poetry
Opción B instalador oficial script compatible con Unix WSL macOS y Windows PowerShell en Unix WSL macOS usa curl -sSL https://install.python-poetry.org | python3 en Windows PowerShell usa Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing | Content | python el instalador oficial indicará si hay que añadir el directorio bin de Poetry al PATH
Verifica la instalación con poetry --version
2) Arreglar PATH si poetry no se encuentra el instalador indica el directorio bin ejemplo ~/.local/bin en Unix o %APPDATA%\\Python\\Scripts en Windows añade esa ruta a tu PATH
3) Recomendada configurar entornos dentro del proyecto para crear virtualenv en .venv usa poetry config virtualenvs.in-project true esto hace que al ejecutar poetry install se genere .venv en la raíz del proyecto añade .venv/ a .gitignore con echo .venv/ >> .gitignore
4) Convertir o inicializar Poetry en tu proyecto Django si ya tienes un proyecto desde la raíz cd /ruta/a/tu-proyecto poetry init interactivo para crear pyproject.toml o usa poetry init --no-interaction para no interactivo luego añade dependencias pyproject.toml y poetry.lock son los archivos que debes commitear en git
Si empiezas un proyecto nuevo mkdir mysite && cd mysite poetry new --src mysite opcional y poetry init --no-interaction
5) Añadir Django y otras dependencias instala Django en el entorno gestionado por Poetry con poetry add django para herramientas de desarrollo ejemplo añade pytest pytest-django black isort con poetry add --group dev pytest pytest-django black isort si tienes requirements.txt puedes importar paquetes uno a uno con poetry add paquete1 paquete2 o en bloque en Unix xargs -n1 poetry add < requirements.txt prueba después si eliges la segunda opción
6) Crear el virtualenv e instalar dependencias ejecuta poetry install para instalar todo y crear el venv si solo quieres dependencias sin instalar tu paquete en modo editable usa poetry install --no-root útil en Docker o CI
7) Usar el virtualenv de Poetry para ejecutar comandos de Django dos formas ejecuta un comando puntual dentro del venv con poetry run python manage.py migrate o poetry run python manage.py runserver o abre una shell del venv con poetry shell luego python manage.py runserver recuerda salir cuando termines exit
8) Fijar intérprete Python si Poetry eligió el Python equivocado indícale cuál usar poetry env use /usr/bin/python3.11 o poetry env use python3.11 esto es útil si usas pyenv o necesitas un interprete concreto
9) Notas sobre commit y flujo de trabajo commitea pyproject.toml y poetry.lock a git añada .venv/ a .gitignore si usas venv en proyecto usa poetry add y poetry remove para cambiar dependencias commitea poetry.lock después de los cambios para actualizar el lockfile sin cambios usa poetry lock --no-update y para actualizar dependencias usa poetry update nombre-paquete
10) Despliegue y CI muchos PaaS o CI esperan requirements.txt puedes exportarlo con poetry export --without-hashes --format=requirements.txt --output=requirements.txt ajusta flags como --without dev según necesites muchas plataformas modernas aceptan instalación directa con Poetry
11) Actualizar Poetry si instalaste con pipx usa pipx upgrade poetry si usaste el instalador oficial usa poetry self update el comportamiento varía según método de instalación
Consejos y problemas comunes si poetry no se encuentra añade el directorio bin indicado al PATH si los comandos de Django no se localizan ejecuta con poetry run o dentro de poetry shell evita editar pyproject.toml a mano usa poetry add para mantener poetry.lock consistente
Sobre Q2BSTUDIO somos Q2BSTUDIO empresa de desarrollo de software y aplicaciones a medida especialistas en software a medida, aplicaciones a medida, inteligencia artificial y ciberseguridad ofrecemos servicios cloud aws y azure así como servicios inteligencia de negocio y soluciones con power bi para mejorar la toma de decisiones nuestra experiencia incluye ia para empresas, agentes IA y proyectos de automatización Si necesitas un partner tecnológico para crear aplicaciones seguras y escalables visita nuestra página de desarrollo de aplicaciones a medida desarrollo de aplicaciones multiplataforma y conoce nuestros servicios de inteligencia artificial en soluciones de inteligencia artificial además ofrecemos ciberseguridad pentesting y despliegues en servicios cloud aws y azure si prefieres que implantemos pipelines de CI o integración con Power BI contamos con experiencia en servicios inteligencia de negocio y agentes IA para empresas
Resumen rápido si buscas instalar Poetry con pip lo más recomendable es usar pipx para aislar la herramienta verifica la versión de Python configura virtualenvs.in-project true si quieres .venv dentro del proyecto usa poetry add para gestionar dependencias y poetry install para crear el entorno y si necesitas ayuda profesional en desarrollo de software a medida seguridad o IA contacta con Q2BSTUDIO