Installation
Diese Anleitung beschreibt die Einrichtung von Duckling für die lokale Entwicklung.
Voraussetzungen
- Python 3.10+ (3.13 empfohlen)
- Node.js 18+
- npm oder yarn
- Git
Schritt-für-Schritt-Installation
1. Repository klonen
2. Backend einrichten
cd backend
python -m venv venv
source venv/bin/activate # Unter Windows: venv\Scripts\activate
pip install -r requirements.txt
3. Frontend einrichten
4. Dokumentation bauen (optional)
Die Backend-Installation enthält bereits MkDocs (gleiche backend/requirements.txt). Vom Repository-Stamm aus:
cd .. # Projektstamm (hier liegt mkdocs.yml)
# Backend-venv nutzen, falls angelegt: source backend/venv/bin/activate
mkdocs build
Für Dokumentations-Builds gilt dieselbe backend/requirements.txt wie für die API (MkDocs-Plugins stehen oben in dieser Datei).
Automatischer Build
Ist MkDocs installiert (über backend/requirements.txt), kann das Backend die Dokumentation bauen, wenn Sie das Dokumentationspanel in der Benutzeroberfläche nutzen.
Umgebungskonfiguration
Umgebungsvariablen Backend
Legen Sie eine .env-Datei im Verzeichnis backend an:
# Flask-Konfiguration
FLASK_ENV=development
SECRET_KEY=your-secret-key
DEBUG=True
# Dateiverarbeitung
MAX_CONTENT_LENGTH=104857600 # 100MB
Sicherheit in Produktion
In Produktion immer einen starken SECRET_KEY setzen und DEBUG=False setzen.
Installation prüfen
Backend prüfen
Sie sollten etwa Folgendes sehen:
Frontend prüfen
Sie sollten etwa Folgendes sehen:
Fehlerbehebung
Probleme mit der Python-Version
Bei Problemen mit der Python-Version:
# Python-Version prüfen
python --version
# Bestimmte Python-Version verwenden
python3.13 -m venv venv
Probleme mit der Node.js-Version
Fehler bei der Abhängigkeitsinstallation
# Backend – pip aktualisieren
pip install --upgrade pip
pip install -r requirements.txt
# Frontend – Cache leeren
rm -rf node_modules package-lock.json
npm install
Nächste Schritte
- Schnellstart – Grundlagen kennenlernen
- Konfiguration – Einstellungen anpassen