Diese Methode richtet sich an Nutzer, die versiert im Umgang mit der Kommandozeile sind und die Anwendung direkt mit Python ausführen möchten.
1. Voraussetzungen: Python & Git installieren
Du benötigst Python 3.10+ und Git.
- macOS: Verwende Homebrew:
brew install python git - Windows: Installiere von git-scm.com und python.org (stelle sicher, dass das Häkchen bei „Add Python to PATH“ gesetzt ist).
- Linux (Debian/Ubuntu):
sudo apt update && sudo apt install git python3 python3-venv python3-pip -y
2. Das Repository klonen
Öffne dein Terminal, navigiere zu dem Ort, an dem du die Anwendung speichern möchtest, und führe folgenden Befehl aus:
git clone https://github.com/mrantonsSG/nova_DSO_tracker.git
cd nova_DSO_tracker
3. Virtuelle Umgebung einrichten und aktivieren
- Umgebung erstellen:Bash
# Auf macOS/Linux python3 -m venv venv # Auf Windows py -3 -m venv venv - Umgebung aktivieren:Bash
# Auf macOS/Linux source venv/bin/activate # Auf Windows .\venv\Scripts\activateDein Terminal-Prompt sollte nun(venv)anzeigen.
4. Abhängigkeiten installieren
Installiere alle benötigten Pakete aus der Datei requirements.txt.
pip install -r requirements.txt
5. Die Anwendung ausführen
Für den Server-Einsatz oder eine langfristige Nutzung (z. B. auf einem Raspberry Pi) wird dringend empfohlen, einen Production-Server wie Gunicorn zu verwenden.
# Zuerst gunicorn innerhalb deines venv installieren
pip install gunicorn
# Dann die App starten
gunicorn --workers 4 --bind 0.0.0.0:5001 nova:app
Öffne nach dem Start deinen Browser und navigiere zu http://localhost:5001.
Zusätzliche Informationen
Virtuelle Umgebung deaktivieren
Sobald du die Anwendung nicht mehr nutzt, kannst du die virtuelle Umgebung einfach wie folgt deaktivieren:
deactivate
Dieser Befehl bringt dich zurück zu deinem normalen Terminal-Prompt. Du musst die Umgebung erneut aktivieren (source venv/bin/activate), bevor du die App wieder startest.
Die Python-Installation aktualisieren
- (Empfohlen) Sichere deine Daten:
cp -r instance instance_backup_$(date +%Y%m%d) - Lade den neuesten Code (Pull):
git pull origin main - Aktiviere deine virtuelle Umgebung:
source venv/bin/activate - Abhängigkeiten aktualisieren:
pip install -r requirements.txt - Starte die Anwendung neu mit dem
gunicorn-Befehl.