Ultralytics Operaciones de gestión de proyectos HUB-SDK
¡Bienvenido a la documentación del HUB-SDK de Ultralytics ! Aquí te guiaremos a través de los aspectos esenciales de la gestión de tus proyectos de aprendizaje automático utilizando el HUB-SDK. Desde crear un nuevo proyecto, actualizar uno existente o navegar por listas de proyectos, lo hemos cubierto todo para ti con fragmentos de código Python fáciles de seguir. Nuestro objetivo es hacer que tu experiencia sea fluida y sencilla, para que puedas centrarte en lo importante: construir y desplegar modelos de aprendizaje automático excepcionales. ¡Vamos a sumergirnos 🏊!
Buscar un proyecto por ID
Cuando ya tienes un proyecto alojado en la plataforma Ultralytics , puede que quieras recuperarlo para ver sus detalles o hacer cambios. Para recuperar un proyecto por su ID único, sólo tienes que pasar el ID a la función client.project función. A continuación se muestra un fragmento que te permite hacer precisamente eso, proporcionando un vistazo rápido a los datos del proyecto:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace '<Project ID>' with your actual project ID
print(project.data)
Crear un nuevo proyecto
¿Estás empezando un nuevo proyecto de ML? ¡Fantástico! El siguiente código de Python describe los pasos para crear un nuevo proyecto en Ultralytics. Importaremos las bibliotecas necesarias, definiremos los detalles del proyecto (en este caso su nombre) y, por último, crearemos el proyecto utilizando la función create_project de nuestra biblioteca cliente HUB-SDK. Te explicamos cómo:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
data = {"meta": {"name": "my project"}} # Name your project
project = client.project() # Initialize a project instance
project.create_project(data) # Create your new project with the specified data
Actualizar proyecto existente
Actualiza los metadatos de tu proyecto con facilidad, especificando el ID del proyecto y los nuevos detalles que deseas incluir. Puede tratarse de un cambio de nombre, una actualización de la descripción o cualquier otra propiedad modificable. Descubre cómo ejecutar estos cambios con este sencillo fragmento de código:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Provide your actual project ID here
project.update({"meta": {"name": "Project name update"}}) # Update the project's name or other metadata
Eliminar un proyecto
Si ya no necesitas un proyecto y deseas eliminarlo de la plataforma Ultralytics , puedes hacerlo con una simple llamada a la función delete en el objeto proyecto. El siguiente fragmento te guiará para eliminar un proyecto utilizando su ID:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Input the project ID for the project to delete
project.delete() # This will permanently delete your project
Listar y navegar por los proyectos
En algunos casos, puede que quieras navegar por tus proyectos o incluso consultar proyectos públicos en Ultralytics. Esto puede hacerse obteniendo una lista de proyectos con el tamaño de página que desees. Nuestro fragmento de código demuestra cómo ver los resultados de la página actual, navegar a la página siguiente y volver a la anterior. Es una forma estupenda de explorar la amplitud de proyectos disponibles:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
projects = client.project_list(page_size=10) # Fetch a list of projects with specified page size
print("Current result:", projects.results) # Display the projects in the current page
projects.next() # Navigate to the next page
print("Next page result:", projects.results) # Display the projects after pagination
projects.previous() # Go back to the previous page
print("Previous page result:", projects.results) # Confirm the projects in the previous page
¡Enhorabuena! Ahora tienes los conocimientos necesarios para gestionar sin esfuerzo tus proyectos de aprendizaje automático en Ultralytics HUB-SDK. Experimenta con estas operaciones y observa cómo tus esfuerzos de ML se vuelven más organizados y eficientes. Si tienes alguna pregunta o necesitas más ayuda, no dudes en ponerte en contacto con nuestra comunidad. ¡Feliz programación! 🚀