Repository mit Gerüst für ein Python 3-basiertes generatives KI-Projekt mit GPU-Beschleunigung unter Verwendung des PyTorch-Ökosystems.
Befolgen Sie einfach die Anweisungen, um aus dieser Vorlage ein neues Projekt-Repository zu erstellen.
Die Projektorganisation basiert auf Ideen von Good Enough Practices for Scientific Computing .
bin
Verzeichnis ab.data
ab.doc
ab.docker
-Verzeichnis ab.env
-Verzeichnis.notebooks
ab.results
ab.src
Verzeichnis ab. Nachdem Sie alle erforderlichen Abhängigkeiten, die per conda
heruntergeladen werden sollen, zur Datei environment.yml
und alle Abhängigkeiten, die per pip
heruntergeladen werden sollen, zur Datei requirements.txt
hinzugefügt haben, erstellen Sie die Conda-Umgebung in einem Unterverzeichnis ./env
Ihres Projektverzeichnisses Führen Sie die folgenden Befehle aus.
export ENV_PREFIX= $PWD /env
mamba env create --prefix $ENV_PREFIX --file environment.yml --force
Sobald die neue Umgebung erstellt wurde, können Sie die Umgebung mit dem folgenden Befehl aktivieren.
conda activate $ENV_PREFIX
Beachten Sie, dass das Verzeichnis ENV_PREFIX
nicht der Versionskontrolle unterliegt, da es bei Bedarf jederzeit neu erstellt werden kann.
Zur Vereinfachung wurden diese Befehle in einem Shell-Skript ./bin/create-conda-env.sh
zusammengefasst. Durch Ausführen des Shell-Skripts wird die Conda-Umgebung erstellt, die Conda-Umgebung aktiviert und JupyterLab mit allen zusätzlichen Erweiterungen erstellt. Das Skript sollte wie folgt aus dem Projektstammverzeichnis ausgeführt werden.
./bin/create-conda-env.sh
Der effizienteste Weg, Conda-Umgebungen auf Ibex zu erstellen, besteht darin, das Umgebungserstellungsskript als Job auf der Debug-Partition über Slurm zu starten. Für Ihre Bequemlichkeit ist ein Slurm-Jobskript ./bin/create-conda-env.sbatch
enthalten. Das Skript sollte wie folgt aus dem Projektstammverzeichnis ausgeführt werden.
sbatch ./bin/create-conda-env.sbatch
Die Liste der expliziten Abhängigkeiten für das Projekt ist in der Datei environment.yml
aufgeführt. Um den vollständigen Verlust der in der Umgebung installierten Pakete anzuzeigen, führen Sie den folgenden Befehl aus.
conda list --prefix $ENV_PREFIX
Wenn Sie Abhängigkeiten zur Datei environment.yml
oder requirements.txt
hinzufügen (entfernen), nachdem die Umgebung bereits erstellt wurde, können Sie die Umgebung mit dem folgenden Befehl neu erstellen.
$ mamba env create --prefix $ENV_PREFIX --file environment.yml --force
Um Docker-Images für Ihr Projekt zu erstellen und Container mit GPU-Beschleunigung auszuführen, müssen Sie Docker, Docker Compose und die NVIDIA Docker-Laufzeitumgebung installieren.
Detaillierte Anweisungen zur Verwendung von Docker zum Erstellen, Abbilden und Starten von Containern finden Sie in docker/README.md
.