Erstellen Sie eine Entwicklungsumgebung.

Bevor Sie Codeänderungen vornehmen, ist es entscheidend, die notwendige Umgebung für die Xinference-Entwicklung einzurichten. Dazu gehören die Vertrautheit mit der Nutzung von Git, die Einrichtung einer isolierten Umgebung, die Installation von Xinference sowie die Kompilierung des Frontend-Teils.

Die Verwendung von Git

Wenn Sie ein Problem beheben, eine Verbesserung hinzufügen oder die Dokumentation überarbeiten müssen, ist es wichtig, mit GitHub und der Xinference-Codebasis vertraut zu sein.

Für neue Benutzer ist die Verwendung von Git einer der einschüchterndsten Aspekte bei der Teilnahme an der Xinference-Entwicklung. Es kann schnell überwältigend wirken, aber die folgende Anleitung hilft, den Prozess zu vereinfachen und potenzielle Probleme zu reduzieren. Wenn Sie auf ein schwieriges Problem stoßen, können Sie gerne in der Community um Hilfe bitten.

Der Code von Xinference wird auf GitHub gehostet. Um zur Codeentwicklung von Xinference beizutragen, musst du ein kostenloses GitHub-Konto registrieren. Wir verwenden Git zur Versionskontrolle, damit alle gemeinsam an der Projektentwicklung teilnehmen können.

Sie können die GitHub-Anleitung befolgen, um Git zu installieren, SSH-Schlüssel einzurichten und Git zu konfigurieren. Sie müssen diese Schritte abschließen, um sicherzustellen, dass Ihr lokales Repository und GitHub ordnungsgemäß funktionieren, damit die nachfolgenden Arbeiten reibungslos durchgeführt werden können.

Hier sind einige gute Ressourcen zum Erlernen von Git:

• Git-Offizielle Dokumentation

• Pro Git Buch

• Atlassian Git-Tutorial

• Git - Kurzanleitung

Bemerkung

Wenn das git clone von Code langsam ist, kann der Proxy mit dem folgenden Befehl hinzugefügt werden:

export https_proxy=YourProxyAddress

Erstellen einer isolierten Umgebung

Es wird empfohlen, vor der offiziellen Installation von Xinference eine isolierte Umgebung mit Conda zu erstellen, um die nachfolgenden Schritte zu erleichtern.

conda create --name xinf
conda activate xinf

xinf kann durch einen benutzerdefinierten Conda-Umgebungsnamen ersetzt werden.

Anschließend müssen in der neu erstellten Conda-Umgebung Python und Node.js (npm) installiert werden. Der Befehl lautet wie folgt:

conda install python=3.12
conda install nodejs

Aus dem Quellcode installieren

Stellen Sie sicher, dass Sie das Repository geklont haben, bevor Sie beginnen. Angenommen, Sie haben das Repository in ein Verzeichnis namens inference geklont, wechseln Sie in dieses Verzeichnis, das die Dateien setup.cfg und setup.py enthält, und führen Sie den folgenden Befehl aus:

pip install -e .
xinference-local

Wenn der Befehl erfolgreich ausgeführt werden kann, können Sie Xinference anschließend normal nutzen. Ein detailliertes Tutorial zur Nutzung finden Sie unter Verwendung.

Falls ein Fehler auftritt oder der Vorgang während der Ausführung hängen bleibt, ist der nächste Schritt die Frontend-Kompilierung.

Frontend-Kompilierung

Zuerst muss in das Verzeichnis inference/xinference/ui/web/ui gewechselt werden, danach wird folgender Befehl ausgeführt, um den Cache zu leeren:

npm cache clean

Wenn die Befehlsausführung fehlschlägt, können Sie versuchen, die Option --force hinzuzufügen.

Bemerkung

Falls der Ordner node_modules bereits in diesem Verzeichnis existiert, wird empfohlen, diesen Ordner zunächst manuell zu löschen.

Führen Sie dann im selben Verzeichnis den folgenden Befehl zur Frontend-Kompilierung aus:

npm install
npm run build

Wenn der erste Befehl fehlschlägt, können Sie dennoch versuchen, das Problem durch Hinzufügen der --force-Option zu beheben.

Nachdem Sie das Frontend kompiliert haben, können Sie in das Verzeichnis mit den Dateien setup.cfg und setup.py zurückkehren und Xinference mit pip install -e . installieren.