Crea l’ambiente di sviluppo.

Prima di apportare qualsiasi modifica al codice, è fondamentale configurare l’ambiente necessario per lo sviluppo di Xinference. Ciò include familiarizzare con l’uso di Git, creare un ambiente isolato, installare Xinference e compilare la parte frontend.

Uso di Git

Quando si ha un problema da risolvere, una funzionalità da aggiungere o una documentazione da migliorare, è importante familiarizzare con il repository GitHub e il codice di Xinference.

Per i nuovi utenti, l’uso di Git è uno degli aspetti più intimidatori del contribuire allo sviluppo di Xinference. Si può rapidamente diventare sopraffatti, ma la guida seguente aiuterà a semplificare il processo e ridurre i potenziali problemi. Se incontri difficoltà irrisolvibili, non esitare a chiedere aiuto nella community.

Il codice di Xinference è ospitato su GitHub. Per contribuire al codice di Xinference, è necessario registrare un account GitHub gratuito. Utilizziamo Git per il controllo di versione, in modo che tutti possano partecipare allo sviluppo del progetto.

Puoi fare riferimento alla Guida di GitHub per installare git, configurare la chiave SSH e impostare git. Devi completare questi passaggi per garantire che il tuo repository locale e GitHub funzionino correttamente, in modo che il lavoro successivo possa procedere senza intoppi.

Ecco alcune ottime risorse per imparare Git:

• Documentazione ufficiale di Git

• Libro Pro Git

• Tutorial Git di Atlassian

• Git - Guida Concisa

Nota

Se durante git clone la velocità di download è lenta, è possibile aggiungere un proxy tramite il seguente comando

export https_proxy=YourProxyAddress

Crea un ambiente isolato.

Prima dell’installazione ufficiale di Xinference, si consiglia di utilizzare Conda per creare un ambiente isolato per facilitare le operazioni successive.

conda create --name xinf
conda activate xinf

xinf può essere sostituito con un nome personalizzato per l’ambiente Conda.

Successivamente, è necessario installare Python e Node.js (npm) nell’ambiente Conda appena creato. I comandi sono i seguenti:

conda install python=3.12
conda install nodejs

Installazione dal codice sorgente

Prima di iniziare, assicurati di aver clonato il repository. Supponendo che tu abbia clonato il repository in una directory chiamata inference, entra in quella directory, dove si trovano i file setup.cfg e setup.py, ed esegui il seguente comando:

pip install -e .
xinference-local

Se il comando viene eseguito con successo, sarà possibile utilizzare Xinference normalmente. Per ulteriori dettagli sul tutorial di utilizzo, consultare uso.

Se si verifica un errore o il sistema si blocca durante l’esecuzione, è necessario procedere con la compilazione frontend.

Compilazione frontend

Prima, è necessario entrare nella directory inference/xinference/ui/web/ui, quindi eseguire il seguente comando per pulire la cache:

npm cache clean

Se il comando fallisce, puoi provare ad aggiungere l’opzione --force.

Nota

Se la directory contiene già la cartella node_modules, si consiglia di eliminarla manualmente prima.

Successivamente, esegui il seguente comando in quella directory per compilare il frontend:

npm install
npm run build

Se il primo comando fallisce, puoi comunque provare a risolverlo aggiungendo l’opzione --force.

Dopo aver compilato il frontend, puoi tornare alla directory che contiene i file setup.cfg e setup.py, quindi installare Xinference tramite pip install -e ..