Inicio rápido: Instalación del HUB-SDK

¡Hola y bienvenido! 🎉 Si buscas integrarte con los servicios de Ultralytics rápidamente y sin complicaciones, has venido al lugar adecuado. Nuestra guía de instalación del HUB-SDK está diseñada para ayudarte a ponerte en marcha en un abrir y cerrar de ojos, con instrucciones claras y paso a paso. Tanto si eres un desarrollador experimentado como si acabas de empezar, nuestro objetivo es proporcionarte un proceso de instalación sencillo y directo. Así que coge tu bebida favorita, ¡y embarquémonos juntos en este viaje de instalación!

Requisitos previos

Antes de sumergirnos en el núcleo de la instalación, asegurémonos de que tenemos todas las herramientas que necesitaremos. Un proceso de instalación sin problemas comienza con la configuración adecuada, así que esto es lo que debes tener a mano:

Python: Es esencial tener Python instalado en tu máquina para trabajar con HUB-SDK. Descarga la última versión de python.org si aún no está instalada en tu sistema.
Git (Opcional): Aunque Git no es obligatorio para instalar HUB-SDK, se recomienda encarecidamente si quieres obtener las últimas y mejores características directamente de la fuente. Puedes obtener Git en git-scm.com.

Una vez eliminados estos requisitos previos, estás preparado para pasar a la fase de instalación.

Métodos de instalación

Dependiendo de tus necesidades, puedes elegir entre dos métodos principales para instalar el HUB-SDK. Esto es lo que ofrece cada método:

Instalar desde PyPI

Si buscas estabilidad y facilidad de instalación, lo mejor es que descargues la última versión estable de HUB-SDK de PyPI. A continuación te explicamos cómo hacerlo con pip, el instalador de paquetes de Python:

pip install hub-sdk

Si ejecutas este comando, obtendrás la versión estable de HUB-SDK y la instalarás directamente en tu entorno Python . Es la forma más rápida de empezar a utilizar HUB-SDK.

Inicializar HUBClient

Una vez completada la instalación, es hora de poner tus manos en el HUBClient. El HUBClient será tu puerta de entrada para interactuar con el ecosistema Ultralytics . A continuación encontrarás dos formas de autenticarte y utilizar el cliente.

Opción A: Utilizar una clave API para la autenticación

Para los que prefieren utilizar claves API por simplicidad y seguridad, aquí tienes cómo configurarlo:

credentials = {"api_key": "<YOUR-API-KEY>"}

Introduce tu clave API real proporcionada por Ultralytics en lugar de <YOUR-API-KEY>. Este es el método preferido cuando las API requieren una clave segura para el acceso.

Opción B: Utilizar un par de correo electrónico/contraseña para la autenticación

Si necesitas utilizar una combinación de correo electrónico y contraseña, es igual de sencillo:

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}

Sustituye <YOUR-EMAIL> y <YOUR-PASSWORD> con tus credenciales de acceso. Este enfoque es más tradicional, pero igualmente robusto.

Por último, crea el objeto HUBClient con el método de credenciales que hayas seleccionado:

Autenticación SDK HUB

Autenticación con clave APIAutenticación con correo electrónico y contraseña

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}  # api key
client = HUBClient(credentials)

from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}  # email and password
client = HUBClient(credentials)

Al ejecutar la línea de código anterior, habrás creado con éxito una instancia del HUBClient, ¡lista para realizar diversas operaciones utilizando los servicios de Ultralytics !

¡Ya está todo listo! 🚀 Ya tienes HUB-SDK instalado y un HUBClient inicializado a tu disposición. A partir de aquí, puedes empezar a sumergirte en las ricas funciones que ofrece el ecosistema Ultralytics . Aprovecha la potencia y flexibilidad de HUB-SDK para tus proyectos, navega por la documentación para explorar qué más puedes hacer, y si te encuentras con algún problema, nuestro amable equipo de soporte está a un clic de distancia. ¡Feliz programación!