Proyecto - Operaciones del HUB-SDK de Ultralytics
¡Bienvenido a la documentación de Ultralytics HUB-SDK! Esta guía te explica los aspectos esenciales de la gestión de tus proyectos de aprendizaje automático utilizando el HUB-SDK. Cubrimos todo, desde la creación de un nuevo proyecto y la actualización de los existentes hasta la navegación por las listas de proyectos, todo ello con fragmentos de código de Python fáciles de seguir. Nuestro objetivo es proporcionar una experiencia fluida y sencilla, que te permita centrarte en la creación e implementación de modelos de aprendizaje automático excepcionales. ¡Empecemos 🏊!
Obtener un proyecto por ID
Para recuperar un proyecto alojado en la plataforma Ultralytics y ver sus detalles o realizar cambios, búsquelo por su ID único. Pase el ID al client.project función como se muestra en el siguiente fragmento:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace '<Project ID>' with your actual project ID
print(project.data) # Displays the project's data
Para obtener más detalles, consulte el referencia para hub_sdk/modules/projects.py.
Crear un nuevo proyecto
Comienza un nuevo proyecto de aprendizaje automático creando un proyecto en Ultralytics HUB. El siguiente código de Python describe cómo definir los detalles del proyecto (en este caso, su nombre) y crear el proyecto utilizando el create_project método:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
data = {"meta": {"name": "my project"}} # Define the project name
project = client.project() # Initialize a project instance
project.create_project(data) # Create the new project with the specified data
Actualizar un proyecto existente
Actualiza fácilmente los metadatos de tu proyecto especificando el ID del proyecto y los nuevos detalles. Esto podría incluir un cambio de nombre, una actualización de la descripción u otras propiedades modificables. Ejecuta estos cambios con el siguiente fragmento de código:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace with your actual project ID
project.update({"meta": {"name": "Project name update"}}) # Update the project's name or other metadata
Eliminar un proyecto
Para eliminar un proyecto de la plataforma Ultralytics, utilice el delete método en el objeto del proyecto. El siguiente fragmento lo guía a través de la eliminación de un proyecto utilizando su ID:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace with the project ID to delete
project.delete() # Permanently deletes the project
Listar y navegar por los proyectos
Explore sus proyectos o descubra proyectos públicos en Ultralytics obteniendo una lista con el tamaño de página deseado. El siguiente fragmento de código muestra cómo ver los resultados de la página actual, navegar a la página siguiente y volver a la anterior:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
projects = client.project_list(page_size=10) # Fetch a list of projects with a specified page size
print("Current result:", projects.results) # Display the projects on the current page
projects.next() # Navigate to the next page
print("Next page result:", projects.results) # Display the projects on the next page
projects.previous() # Go back to the previous page
print("Previous page result:", projects.results) # Confirm the projects on the previous page
¡Enhorabuena! Ahora está equipado para gestionar sus proyectos de aprendizaje automático en Ultralytics HUB sin esfuerzo. Experimente con estas operaciones para mejorar la organización y la eficiencia de sus proyectos de ML. Si tiene alguna pregunta o necesita más ayuda, no dude en ponerse en contacto con nuestra comunidad. ¡Feliz codificación! 🚀
