Instala tu paquete pip desde GitHub

Contenido del curso

Fundamentos de Git y control de versiones

Introducción a GitHub

Herramientas de colaboración en GitHub

GitHub Codespaces

Seguridad y buenas prácticas en GitHub

Administración de GitHub

Gestión de Cambios con Pull Requests

GitHub Releases

Cierre

42
Pro tips ocultos de GitHub para trabajar mejor
10:13 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:006:57

Instala tu paquete pip desde GitHub

Curso de Git y GitHub

Clase 41 de 42

Clase 41 / 42

Recursos

Publicar un release en GitHub te permite versionar tu código y distribuirlo como paquete instalable. Aquí verás cómo crear un release con tag, adjuntar binarios y consumir ese paquete pip desde una aplicación Python local, ideal si estás aprendiendo a empaquetar y distribuir software propio.

¿Cómo se crea un nuevo release en GitHub?

Dentro de tu repositorio, busca la sección Releases a la derecha y selecciona la opción para crear uno nuevo. El formulario te pedirá un tag, que es la versión que quieras publicar.

En este caso usamos v0.1.0, tomando como base la rama main. Si no recuerdas qué versión declaraste en tu proyecto, vuelve a Visual Studio Code y revisa la versión configurada ahí mismo. Mantener coherencia entre la versión del proyecto y el tag del release evita confusiones futuras [01:00].

¿Qué es un tag en GitHub? Es una etiqueta que marca un punto específico del historial del repositorio, normalmente asociado a una versión como v0.1.0. Sirve como referencia inmutable para tus releases.

En el campo release title se acostumbra reutilizar el mismo tag como título, así que escribe v0.1.0. La descripción puede quedar vacía si es tu primera prueba.

¿Debo subir binarios o solo el código fuente?

Si no te sientes seguro publicando solamente el código fuente, GitHub te permite adjuntar binarios. Dentro de tu proyecto, los binarios viven en la carpeta dist y suelen tener dos formatos:

Archivo .tar.gz, una distribución comprimida del código fuente.
Archivo .whl, el formato wheel recomendado para instalar con pip.

Selecciónalos, ábrelos y quedarán adjuntos al release. Si esta es tu primera versión estable, no marques pre-release y publica directamente con el botón correspondiente [02:15].

¿Cómo consumir tu paquete pip desde otra aplicación Python?

Una vez publicado el release, cambia de lugar de trabajo y abre otro repositorio donde vivirá la aplicación que consumirá el paquete. Desde la terminal escribe code . para abrir Visual Studio Code en esa carpeta.

Dentro del repositorio crea una carpeta llamada app y, dentro de ella, un archivo app.py. Esa será tu aplicación cliente.

¿Cómo instalo un paquete pip desde una URL de GitHub?

Ve a tu release publicado, haz clic derecho sobre el archivo .whl y copia el enlace. En la terminal ejecuta:

bash pip3 install <URL-del-archivo-whl>

Eso descargará e instalará tu paquete directamente desde GitHub, sin necesidad de subirlo a PyPI todavía. Para verificar que quedó instalado, usa:

bash pip3 list

El comando muestra en orden alfabético todos los paquetes disponibles en tu entorno. Ahí debería aparecer tu paquete con la versión 0.1.0 [03:40].

¿Para qué sirve pip3 list? Lista todos los paquetes instalados en tu entorno Python con sus versiones. Es la forma rápida de confirmar que una instalación se completó correctamente.

¿Cómo importo y uso el paquete en mi código?

En app.py importa el módulo y usa la función que expusiste en tu paquete. Si tu paquete se llama tercer_repo y contiene un método saludo, el código queda así:

python from tercer_repo import saludo

print(saludo("Platzi"))

Desde la terminal entra a la carpeta con cd app y ejecuta python3 app.py. La salida será el mensaje definido en tu paquete, por ejemplo: Hola, Platzi, desde el repo de Platzi [04:50].

Acabas de cerrar el ciclo: creaste un paquete, lo publicaste como release en GitHub y lo consumiste desde una aplicación independiente. Ese mismo flujo aplica si trabajas con NuGet en .NET o con NPM en Node, solo cambian las herramientas de empaquetado y los comandos de instalación.

¿Qué habilidades y conceptos clave dominas tras este flujo?

Este ejercicio te deja varias capacidades concretas listas para reutilizar en otros proyectos.

Versionado semántico con tags tipo v0.1.0 para marcar puntos del historial.
Publicación de releases en GitHub con binarios .whl y .tar.gz.
Instalación de paquetes pip desde URLs externas, sin depender de PyPI.
Verificación de entornos Python con pip3 list.
Importación y consumo de tu propio paquete en una aplicación cliente.

Si ya creaste paquetes pip, npm o NuGet siguiendo este patrón, compártelos en los comentarios para que la comunidad pueda probarlos. ¿Qué función incluirías en la primera versión de tu paquete?

Mario Alexander Vargas Celis

Hace 2 años

Publicación de Paquetes en GitHub y PyPI 🚀

📌 ¿Por qué publicar paquetes?

Publicar un paquete en GitHub o PyPI (Python Package Index) permite compartir código reutilizable con la comunidad o facilitar su distribución dentro de un equipo de trabajo.

🔹 Publicación en GitHub Packages

GitHub Packages permite almacenar y distribuir paquetes de software junto con el código fuente del proyecto.

1️⃣ Configurar el archivo setup.py

from setuptools import setup, find_packages

setup( name="miproyecto", version="0.1.0", packages=find_packages(), install_requires=[ "numpy", # Dependencias del paquete ], author="Tu Nombre", author_email="tuemail@example.com", description="Descripción breve del paquete", url="https://github.com/tuusuario/miproyecto", )

2️⃣ Crear un archivo .pypirc

En la carpeta de usuario (~/.pypirc en Linux/Mac o C:\Users\TU_USUARIO\.pypirc en Windows), añade:

[distutils] index-servers = github

[github] repository = username = __token__ password = TU_GITHUB_TOKEN

💡 Importante: Genera un token en GitHub > Settings > Developer settings > Personal access tokens con permisos de write:packages.

3️⃣ Construir y subir el paquete a GitHub Packages

pip install build twine python -m build twine upload --repository github dist/*

🔹 Publicación en PyPI (Python Package Index)

PyPI es el repositorio oficial de paquetes de Python.

1️⃣ Crear una cuenta en PyPI

📌 Ve a y crea una cuenta.

2️⃣ Configurar setup.py (igual que en GitHub)

3️⃣ Crear el archivo pyproject.toml

Añade el siguiente contenido para definir los requisitos de construcción:

[build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta"

4️⃣ Construir el paquete

python -m build

5️⃣ Subir el paquete a PyPI

twine upload dist/*

Esto pedirá tus credenciales de PyPI (usuario y contraseña o token de acceso).

💡 Diferencias Clave entre GitHub Packages y PyPI

CaracterísticaGitHub PackagesPyPI (Python Package Index)Público/PrivadoPuede ser privado o públicoSolo públicoIntegraciónDirectamente con GitHubIndependiente de GitHubDistribuciónRequiere autenticación para instalar paquetes privadosAccesible sin autenticación

📥 Instalación de paquetes desde GitHub y PyPI

✅ Desde PyPI:

pip install miproyecto

✅ Desde GitHub (paquete público):

pip install git+https://github.com/tuusuario/miproyecto.git

✅ Desde GitHub Packages (paquete privado):

pip install --index-url miproyecto

💡 Conclusión: Publicar paquetes en GitHub Packages es útil para proyectos privados, mientras que PyPI es ideal para compartir código con la comunidad de Python. 🚀

Comentarios (30)30 comentarios

Diego Andrés Lopez Rodriguez

Jose Luis Bedoya

Jean Grober

Hace un año

Ricardo Ivan Herrera Rocha

Albert Jose Salas Yustiz

Felipe Martínez Díaz

Amin Espinoza

Profesor

Gabriel Obregón

Luis Quiroz Prada

Jennifer Cano

Dussan Freire

Hace 10 meses

David Agudelo

JHOFRED JAHAT CAMACHO GOMEZ

bl3ssedc0de .

Hace 7 meses

Diego Mauricio Zuluaga Rodríguez

Hace 5 meses

Toni Alexander Ramírez Abrego

Paul Andrés Andia Frias

Hace un mes

Daniel Vergel

Hace 2 meses

Hace 6 meses

José Lancheros Ayora

William Serrano

Fundamentos de Git y control de versiones

Control de Versiones con Git y GitHub: De Básico a Avanzado

Fundamentos de Git: Configuración y Comandos Básicos

Control de Versiones con Git: Comandos Básicos y Flujo de Trabajo

Gestión de ramas en Git: creación, fusión y eliminación eficiente

Git reset vs revert para deshacer commits

Git Tag y Checkout sin romper tu proyecto

Cómo resolver conflictos de merge en Git

Uso de Git en Visual Studio Code

Introducción a GitHub

Uso de GitHub para Colaboración y Desarrollo Seguro

Cómo crear y proteger tu cuenta de GitHub

Proceso de Trabajo con Git y GitHub: Creación y Revisión de Repositorios

Crea y clona tu primer repo en GitHub

Precios y Planes de Productos de Github

Configuración de SSH en GitHub para Windows, Linux y Mac

Uso de Forks y Estrellas en Repositorios de GitHub

Uso de git pull, git push y git fetch en repositorios GitHub

Plantillas de issues en GitHub paso a paso

Uso de Pull Requests en GitHub para Colaboración Efectiva

Herramientas de colaboración en GitHub

GitHub Projects para gestionar tareas en equipo

Automatiza GitHub Projects con workflows

Recursos Esenciales de Markdown para Documentación Efectiva

Creación de una Portada de Perfil en GitHub con Markdown

Creación y Gestión de Wikis en GitHub

Uso de GitHub Gist para Compartir y Revisar Código Colaborativo

Creación y Publicación de Sitios Web con GitHub Pages

GitHub Codespaces

Creación y Gestión de GitHub Codespaces en la Nube

Plantillas de Codespaces con Django y devcontainer

Pair programming con Live Share en Codespaces

Uso del Editor Web de GitHub para Edición Rápida de Archivos

Seguridad y buenas prácticas en GitHub

Gestión de GitHub Tokens para Acceso Seguro a Repositorios

Secret Scanning en GitHub y sus límites

Gestión de Seguridad de Paquetes con Dependabot en Proyectos .NET

Repositorios privados y .gitignore en GitHub

Administración de GitHub

Creación y gestión de repositorios en GitHub

Automatización de GitHub Actions para Actualizar Perfil

Gestiona GitHub desde tu terminal con gh

Gestión de Cambios con Pull Requests

Configuración de Proyectos de Software con Git y GitHub

Cómo resolver conflictos de merge en VS Code

Estrategias de Fusión de Ramas en Git

GitHub Releases

Creación de Releases en Github para Desarrolladores de Software

Instala tu paquete pip desde GitHub

Cierre

Pro tips ocultos de GitHub para trabajar mejor

Instala tu paquete pip desde GitHub