项目 - 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>"} # 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
有关更多详细信息,请参见 参考 hub_sdk/modules/projects.py
.
创建新项目
通过以下方式开始一个新的机器学习项目 创建一个项目 在 Ultralytics HUB 中。以下 python 代码概述了如何定义项目详细信息(在本例中为其名称)并使用以下代码创建项目 create_project
方法:
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
更新现有项目
通过指定项目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 your actual project ID
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>"} # 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
列出和导航项目
通过获取具有所需页面大小的列表,浏览您的项目或在 Ultralytics 上探索 公共项目。下面的代码片段演示了如何查看当前页面结果、导航到下一页以及返回到上一页:
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
恭喜!您现在可以轻松地在 Ultralytics HUB 上管理您的机器学习项目。尝试这些操作,以提高您的 ML 工作的组织性和效率。如有任何问题或需要进一步帮助,请随时联系我们的社区。祝您编码愉快!🚀
📅 1 年前创建
✏️ 1 个月前更新