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

Olá e bem-vindo! Se pretende integrar-se com os serviços Ultralytics de forma rápida e sem complicações, veio ao sítio certo. O nosso guia de instalação do HUB-SDK foi concebido para o ajudar a começar a trabalhar rapidamente com instruções claras e passo a passo. Quer seja um programador experiente ou esteja apenas a começar, o nosso objetivo é fornecer-lhe um processo de configuração fácil e direto. Por isso, pegue na sua bebida preferida e vamos embarcar juntos nesta viagem de instalação!

Pré-requisitos

Antes de nos debruçarmos sobre o núcleo da instalação, vamos certificar-nos de que temos todas as ferramentas de que necessitamos. Um processo de instalação sem problemas começa com a configuração correta, por isso, eis o que deve ter à mão:

Python: É essencial ter o Python instalado na sua máquina para trabalhar com o HUB-SDK. Descarregue a última versão de python.org se ainda não estiver instalada no seu sistema.
Git (opcional): Embora o Git não seja obrigatório para instalar o HUB-SDK, ele é altamente recomendado se você quiser obter os melhores e mais recentes recursos diretamente da fonte. O Git pode ser obtido em git-scm.com.

Com estes pré-requisitos ultrapassados, está tudo pronto para passar à fase de instalação.

Métodos de instalação

Dependendo das suas necessidades, pode escolher entre dois métodos principais para instalar o HUB-SDK. Veja o que cada caminho tem a oferecer:

Instalando a partir do PyPI

Se você está procurando por estabilidade e facilidade de instalação, pegar a última versão estável do HUB-SDK do PyPI é o caminho a seguir. Veja como 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 no seu ambiente Python . É o caminho mais rápido para começar a usar o HUB-SDK.

Inicializar o HUBClient

Quando a instalação estiver concluída, é hora de colocar as mãos no HUBClient. O HUBClient será a sua porta de entrada para interagir com o ecossistema Ultralytics . Abaixo pode 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 configurá-las:

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

Insira a sua 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 precisar de utilizar uma combinação de e-mail/palavra-passe, é igualmente simples:

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

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

Por fim, crie o objeto HUBClient com o método de credencial selecionado:

Autenticação do HUB SDK

Autenticação com chave APIAutenticação com e-mail e palavra-passe

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 executar a linha de código acima, criou com êxito uma instância do HUBClient, pronta para efetuar várias operações utilizando os serviços Ultralytics !

Está tudo pronto! Agora você tem o HUB-SDK instalado e um HUBClient inicializado à sua disposição. A partir daqui, você pode começar a mergulhar nos recursos avançados fornecidos pelo ecossistema Ultralytics . Aproveite o poder e a flexibilidade do HUB-SDK para seus projetos, navegue pela documentação para explorar o que mais você pode fazer e, se encontrar algum problema, nossa equipe de suporte amigável estará a apenas um clique de distância. Boa programação!