3.1 KiB
3.1 KiB
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.
✨ 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:
- Im Heimnetzwerk: Öffnet am Smartphone einfach
http://192.168.178.X:3000(IP-Adresse eures Servers). - Unterwegs (Optional): Nutzt kostenlos Cloudflare Tunnel oder Nginx Reverse Proxy mit Let's Encrypt SSL.