Files
Kitchen2/README.md
T

3.1 KiB
Raw Blame History

KitchenStock ❤️ Veganes Küchen- & Vorratsmanagement für Amy & Mandy

Ein modernes, helles und schnelles Web-App-System für euren veganen Vorrat, eure Einkaufsliste und KI-Rezepttipps.

KitchenStock Light UI Diet AI Model


Features

  • 🌿 100% Vegan Guard: Automatische Warnanzeige (🚨 NICHT VEGAN!), falls versehentlich ein tierisches Produkt gewählt wird.
  • 🏬 Supermarkt-Vorauswahl: Filtert die Einkaufsliste & Vorschläge direkt nach REWE, Kaufland, Lidl und ALDI.
  • 📦 130+ Vegane Marken-Produkte: Vorinstallierter Katalog mit REWE Beste Wahl, Kaufland K-PLANT BASED, Lidl Vemondo, ALDI MYVAY, Alpro, Oatly, Rügenwalder Mühle, Billie Green, Beyond Meat, Simply V & Violife.
  • 🎚️ Gramm-Schritt-Slider: Realistische Vorrats-Anpassung in [50g, 100g, 250g, 500g, 1000g] Schritten (und 1-Stück für Flaschen/Packungen).
  • 💡 KI-Rezepttipps per 1-Tap: Blitzschnelle 100% vegane Rezeptidee auf jeder Vorratskarte.
  • 🤖 Gemma 31B KI-Küche: Token-sparendes KI-Modell für Wochenpläne, Resteverwertung & Einkaufsberater.
  • 🕒 Zuletzt benutzte Artikel: Merkt sich eure Lieblingszutaten für 1-Tap Nachbestellung.

🖥️ Lokales Server-Deployment (Self-Hosted)

Ihr könnt die App ganz einfach auf eurem eigenen lokalen Server (Home-Server, Raspberry Pi, Ubuntu/Debian Linux, Windows Server, Synology NAS) betreiben.

Methode 1: PM2 / Direct Node.js (Empfohlen)

Voraussetzung: Node.js (v18+) auf dem Server installiert.

# 1. Repository auf den Server klonen
git clone https://github.com/immissmandy/Kitchen.git
cd Kitchen

# 2. .env.local anlegen
cat <<EOT > .env.local
GEMINI_API_KEY=AQ.Ab8RN6IF-hRoe09JrDVAAktkIAPu400_bnh8egCVa8nuTYyAPQ
GEMINI_MODEL=gemma-2-27b-it
NEXT_PUBLIC_APP_URL=http://<EURE_SERVER_IP>:3000
EOT

# 3. Abhängigkeiten installieren & Production Build erstellen
npm install
npm run build

# 4. PM2 Process Manager installieren & App starten (Dauerhafter Hintergrundbetrieb)
npm install -g pm2
pm2 start npm --name "kitchen-stock" -- start

# 5. Automatischer Server-Neustart aktivieren
pm2 startup
pm2 save

Die App ist jetzt dauerhaft unter http://<EURE_SERVER_IP>:3000 im Heimnetzwerk erreichbar!


Methode 2: Docker Compose (1-Klick Container)

Falls ihr Docker auf eurem Heimserver nutzt (Synology, Unraid, Portainer, Docker Desktop):

# 1. Repository klonen
git clone https://github.com/immissmandy/Kitchen.git
cd Kitchen

# 2. Container starten
docker compose up -d --build

Fertig! Der Docker-Container startet automatisch neu, wenn der Server neu gestartet wird.


🌐 Zugriff im Heimnetzwerk & SSL

Damit Amy & Mandy die App bequem auf dem Smartphone öffnen können:

  1. Im Heimnetzwerk: Öffnet am Smartphone einfach http://192.168.178.X:3000 (IP-Adresse eures Servers).
  2. Unterwegs (Optional): Nutzt kostenlos Cloudflare Tunnel oder Nginx Reverse Proxy mit Let's Encrypt SSL.