Avvio rapido: Installazione di HUB-SDK

Ciao e benvenuto! 🎉 Se state cercando di integrarvi con i servizi di Ultralytics in modo rapido e senza problemi, siete nel posto giusto. La nostra guida all'installazione di HUB-SDK è stata progettata per aiutarvi a essere operativi in pochissimo tempo con istruzioni chiare e passo dopo passo. Che siate sviluppatori esperti o alle prime armi, il nostro obiettivo è quello di fornirvi un processo di installazione semplice e diretto. Quindi, prendete la vostra bevanda preferita e intraprendiamo insieme questo viaggio di installazione!

Prerequisiti

Prima di immergerci nel cuore dell'installazione, assicuriamoci di avere tutti gli strumenti necessari. Un processo di installazione senza problemi inizia con la giusta configurazione, quindi ecco cosa dovreste avere a portata di mano:

Python: Per lavorare con HUB-SDK è essenziale che Python sia installato sul computer. Scaricare l'ultima versione da python.org se non è già installata sul sistema.
Git (opzionale): Sebbene Git non sia obbligatorio per l'installazione di HUB-SDK, è fortemente raccomandato se si vogliono ottenere le ultime e più importanti funzionalità direttamente dalla fonte. Git può essere ottenuto da git-scm.com.

Una volta eliminati questi prerequisiti, si è pronti a passare alla fase di installazione.

Metodi di installazione

A seconda delle vostre esigenze, potete scegliere tra due metodi principali per installare l'HUB-SDK. Ecco cosa offre ciascun percorso:

Installazione da PyPI

Se cercate stabilità e facilità d'installazione, l'ultima versione stabile di HUB-SDK da PyPI è la soluzione migliore. Ecco come fare con pip, il programma di installazione dei pacchetti di Python:

pip install hub-sdk

Eseguendo questo comando si preleva la versione stabile di HUB-SDK e la si installa direttamente nell'ambiente Python . È il modo più rapido per iniziare a usare HUB-SDK.

Inizializzare HUBClient

Una volta completata l'installazione, è il momento di mettere le mani su HUBClient. L'HUBClient sarà la porta d'accesso per interfacciarsi con l'ecosistema Ultralytics . Di seguito sono riportati due modi per autenticarsi e utilizzare il client.

Opzione A: Utilizzo di una chiave API per l'autenticazione

Per coloro che preferiscono utilizzare le chiavi API per semplicità e sicurezza, ecco come configurarle:

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

Inserite la vostra chiave API effettiva fornita da Ultralytics al posto di <YOUR-API-KEY>. Questo è il metodo preferito quando le API richiedono una chiave sicura per l'accesso.

Opzione B: utilizzo di una coppia e-mail/password per l'autenticazione

Se è necessario utilizzare una combinazione di e-mail e password, è altrettanto semplice:

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

Sostituire <YOUR-EMAIL> e <YOUR-PASSWORD> con le proprie credenziali di accesso. Questo approccio è più tradizionale ma altrettanto robusto.

Infine, creare l'oggetto HUBClient con il metodo di credenziali selezionato:

Autenticazione HUB SDK

Autenticazione con chiave APIAutenticazione con e-mail e password

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)

Eseguendo la riga di codice precedente, si è creata con successo un'istanza di HUBClient, pronta a eseguire varie operazioni utilizzando i servizi di Ultralytics !

È tutto pronto! Ora avete installato HUB-SDK e un HUBClient inizializzato a vostra disposizione. Da qui, potete iniziare a immergervi nelle ricche funzionalità offerte dall'ecosistema Ultralytics . Sfruttate la potenza e la flessibilità di HUB-SDK per i vostri progetti, navigate nella documentazione per scoprire cosa si può fare di più e, in caso di problemi, il nostro team di supporto è a portata di clic. Buona programmazione!