跳至内容

Ultralytics HUB-SDK 项目管理运行

欢迎访问Ultralytics HUB-SDK 文档！在这里，我们将指导您使用 HUB-SDK 管理机器学习项目的基本要素。从创建新项目、更新现有项目到浏览项目列表，我们都将通过简单易懂的Python 代码片段为您一一介绍。我们的目标是让您体验到无缝和直接的体验，这样您就可以专注于重要的事情--构建和部署卓越的机器学习模型。让我们开始吧 🏊！

通过 ID 获取项目

如果您已经在Ultralytics 平台上托管了一个项目，您可能希望检索该项目以查看其详细信息或进行更改。要通过项目的唯一 ID 获取项目，只需将 ID 传递给 client.project 功能。下面的代码段就可以让您快速查看项目数据：

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)

创建新项目

您要开始一个全新的 ML 项目吗？太好了！下面的Python 代码概述了在Ultralytics 上创建新项目的步骤。我们将导入必要的库，定义项目细节（此处为项目名称），最后使用 create_project 方法。具体方法如下

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

更新现有项目

只需指定项目 ID 和要包含的新详细信息，即可轻松更新项目元数据。这可能是名称更改、描述更新或任何其他可修改的属性。了解如何通过这个简单的代码片段执行这些更改：

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

删除项目

如果您不再需要某个项目，并希望将其从Ultralytics 平台上删除，只需简单调用 delete 方法删除项目对象。下面的代码段将指导你使用项目 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

项目列表和导航

在某些情况下，您可能希望浏览自己的项目，甚至查看Ultralytics 上的公开项目。这可以通过获取具有所需页面大小的项目列表来实现。我们的代码片段演示了如何查看当前页结果、导航到下一页，然后返回到上一页。这是一种探索可用项目广度的好方法：

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

恭喜您！您现在已经掌握了在Ultralytics HUB-SDK 上轻松管理机器学习项目的知识。请尝试使用这些操作，看看你的机器学习项目是否变得更有条理、更高效。如果您有任何疑问或需要进一步帮助，请随时联系我们的支持社区。祝您编码愉快！🚀


评论