Início rápido: Instalando o HUB-SDK

Olá e sê bem-vindo! 🎉 Se pretendes fazer a integração com os serviços Ultralytics de forma rápida e sem complicações, vieste ao sítio certo. O nosso guia de instalação do HUB-SDK foi concebido para te ajudar a começar a trabalhar rapidamente com instruções claras e passo a passo. Quer sejas um programador experiente ou estejas apenas a começar, o nosso objetivo é fornecer-te um processo de configuração fácil e direto. Por isso, pega na tua bebida favorita e vamos embarcar juntos nesta viagem de instalação!

Pré-requisitos

Antes de mergulharmos no núcleo da instalação, vamos certificar-nos de que temos todas as ferramentas de que necessitamos. Um processo de instalação suave começa com a configuração correcta, por isso, eis o que deves ter à mão:

Python: É essencial ter o Python instalado na tua máquina para trabalhares com o HUB-SDK. Descarrega a última versão de python.org se ainda não estiver instalada no teu sistema.
Git (opcional): Embora o Git não seja obrigatório para instalar o HUB-SDK, é fortemente recomendado se quiseres obter as melhores e mais recentes funcionalidades diretamente da fonte. O Git pode ser obtido em git-scm.com.

Com estes pré-requisitos fora do caminho, estás preparado para passar à fase de instalação.

Métodos de instalação

Dependendo das tuas necessidades, podes escolher entre dois métodos principais para instalar o HUB-SDK. Vê aqui o que cada caminho tem para oferecer:

Instalando a partir do PyPI

Se estás à procura de estabilidade e facilidade de instalação, agarrar a última versão estável do HUB-SDK do PyPI é o caminho a seguir. Aqui está como podes fazer isso com o pip, o instalador de pacotes do Python:

pip install hub-sdk

Executar este comando irá puxar a versão estável do HUB-SDK e instalá-lo diretamente em seu ambiente Python . É o caminho mais rápido para começar a usar o HUB-SDK.

Inicializa o HUBClient

Quando a instalação estiver concluída, é hora de pores as mãos no HUBClient. O HUBClient será a tua porta de entrada para interagir com o ecossistema Ultralytics . Abaixo podes encontrar duas formas de autenticar e utilizar o cliente.

Opção A: Utilizar uma chave de API para autenticação

Para aqueles que preferem utilizar chaves de API por motivos de simplicidade e segurança, eis como podes configurá-las:

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}

Insere a tua chave de API real fornecida por Ultralytics em vez de <YOUR-API-KEY>. Este é o método preferido quando as APIs requerem uma chave segura para acesso.

Opção B: Utilizar um par de e-mail/palavra-passe para autenticação

Se tiveres de utilizar uma combinação de e-mail/palavra-passe, é igualmente simples:

from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}

Substitui <YOUR-EMAIL> e <YOUR-PASSWORD> com as tuas credenciais de início de sessão. Esta abordagem é mais tradicional, mas igualmente robusta.

Por fim, cria o objeto HUBClient com o método de credenciais que seleccionaste:

Autenticação do HUB SDK

Autenticação com chave APIAutenticação com e-mail e senha

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)

from hub_sdk import HUBClient

credentials = {"email": "<YOUR-EMAIL>", "password": "<YOUR-PASSWORD>"}  # email and password
client = HUBClient(credentials)

Ao executares a linha de código acima, criaste com sucesso uma instância do HUBClient, pronta para executar várias operações utilizando os serviços Ultralytics !

Estás pronto! 🚀 Agora tens o HUB-SDK instalado e um HUBClient inicializado à tua disposição. A partir daqui, podes começar a mergulhar nas ricas funcionalidades fornecidas pelo ecossistema Ultralytics . Aproveita o poder e a flexibilidade do HUB-SDK para os teus projectos, navega pela documentação para explorar o que mais podes fazer, e se encontrares algum problema, a nossa simpática equipa de suporte está apenas a um clique de distância. Boa programação!