Projeto - Operações Ultralytics HUB-SDK
Bem-vindo à documentação do Ultralytics HUB-SDK! Este guia explica o essencial do gerenciamento de seus projetos de aprendizado de máquina usando o HUB-SDK. Abordamos tudo, desde a criação de um novo projeto e a atualização dos existentes até a navegação por listas de projetos, tudo com trechos de código Python fáceis de seguir. Nosso objetivo é fornecer uma experiência simples e direta, permitindo que você se concentre na construção e implantação de modelos de aprendizado de máquina excepcionais. Vamos começar 🏊!
Buscar um Projeto por ID
Para recuperar um projeto hospedado na plataforma Ultralytics e visualizar seus detalhes ou fazer alterações, busque-o pelo seu ID exclusivo. Passe o ID para o client.project função, conforme mostrado no trecho abaixo:
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 mais detalhes, veja o referência para hub_sdk/modules/projects.py.
Criar um Novo Projeto
Comece um novo projeto de machine learning por criando um projeto no Ultralytics HUB. O seguinte código Python descreve como definir os detalhes do projeto (neste caso, seu nome) e criar o projeto usando o 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
Atualizar um Projeto Existente
Atualize facilmente os metadados do seu projeto, especificando o ID do projeto e os novos detalhes. Isso pode incluir uma alteração de nome, atualização da descrição ou outras propriedades modificáveis. Execute estas alterações com o seguinte 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
Excluir um Projeto
Para remover um projeto da plataforma Ultralytics, use o delete método no objeto do projeto. O seguinte trecho orienta você na exclusão de um projeto usando seu 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 e Navegar por Projetos
Navegue pelos seus projetos ou explore projetos públicos na Ultralytics, buscando uma lista com o tamanho de página desejado. O trecho de código abaixo demonstra como visualizar os resultados da página atual, navegar para a próxima página e retornar à 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
Parabéns! Agora você está equipado para gerenciar seus projetos de aprendizado de máquina no Ultralytics HUB sem esforço. Experimente estas operações para melhorar a organização e a eficiência de seus empreendimentos de ML. Para quaisquer perguntas ou assistência adicional, sinta-se à vontade para entrar em contato com nossa comunidade. Boa programação! 🚀
