Ultralytics Opérations de gestion de projet HUB-SDK
Bienvenue dans la documentation de Ultralytics HUB-SDK ! Ici, nous vous guiderons à travers les éléments essentiels de la gestion de vos projets d'apprentissage automatique à l'aide du HUB-SDK. De la création d'un nouveau projet à la mise à jour d'un projet existant, en passant par la navigation dans les listes de projets, nous avons tout couvert pour vous avec des extraits de code Python faciles à suivre. Notre objectif est de rendre votre expérience transparente et simple, afin que vous puissiez vous concentrer sur les choses importantes - construire et déployer des modèles d'apprentissage machine exceptionnels. Plongeons dans l'aventure 🏊 !
Recherche d'un projet par ID
Lorsque vous avez déjà un projet hébergé sur la plateforme Ultralytics , vous pouvez vouloir le récupérer pour en voir les détails ou y apporter des modifications. Pour récupérer un projet par son identifiant unique, il vous suffit de passer l'identifiant à la fonction client.project
fonction. Vous trouverez ci-dessous un extrait qui vous permet d'effectuer cette opération et de jeter un coup d'œil rapide aux données du projet :
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)
Créer un nouveau projet
Vous commencez un nouveau projet ML ? C'est fantastique ! Le code suivant Python décrit les étapes de la création d'un nouveau projet sur Ultralytics. Nous allons importer les bibliothèques nécessaires, définir les détails du projet (dans ce cas, son nom) et enfin créer le projet à l'aide de la commande create_project
de notre bibliothèque client HUB-SDK. Voici comment procéder :
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
Mise Ă jour du projet existant
Mettez facilement à jour les métadonnées de votre projet en spécifiant l'identifiant du projet et les nouveaux détails que vous souhaitez inclure. Il peut s'agir d'un changement de nom, d'une mise à jour de la description ou de toute autre propriété modifiable. Découvrez comment effectuer ces changements grâce à cet extrait de code simple :
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
Supprimer un projet
Si vous n'avez plus besoin d'un projet et que vous souhaitez le supprimer de la plateforme Ultralytics , vous pouvez le faire par un simple appel Ă la fonction delete
sur l'objet projet. L'extrait suivant vous guidera dans la suppression d'un projet Ă l'aide de son identifiant :
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
Liste et navigation dans les projets
Dans certains cas, vous pouvez souhaiter parcourir vos projets ou même consulter des projets publics sur Ultralytics. Pour ce faire, vous pouvez récupérer une liste de projets avec la taille de page souhaitée. Notre extrait de code montre comment afficher les résultats de la page actuelle, naviguer vers la page suivante, puis revenir à la page précédente. C'est un excellent moyen d'explorer l'étendue des projets 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
Félicitations ! Vous disposez désormais des connaissances nécessaires pour gérer sans effort vos projets d'apprentissage automatique sur Ultralytics HUB-SDK. Expérimentez ces opérations et observez vos projets d'apprentissage machine devenir plus organisés et plus efficaces. Si vous avez des questions ou si vous avez besoin d'aide, n'hésitez pas à contacter notre communauté. Bon codage ! 🚀