callum2254/cegin repository overview

Cegin

A self-hosted recipe app with Chef Terry, your AI cooking assistant.

Plan meals, scan your fridge, get push notifications, and cook with personality — all on your own hardware.

Quick start

bash
docker pull callum2254/cegin


bash
docker run -d \
  -p 3000:3000 \
  -v cegin-data:/data \
  callum2254/cegin


Then open http://localhost:3000 on your phone or desktop.

Features

- Recipe library — import from URL, search, tag, scale servings, organize into collections
- Chef Terry — AI chat with kitchen context (DeepSeek, OpenAI, Groq, Ollama, or any OpenAI-compatible endpoint)
- Terry Vision — scan your fridge for recipe suggestions
- Scan recipe — extract recipes from photos (OCR)
- Meal planner — weekly breakfast/lunch/dinner with AI fill
- Shopping list — auto-generated from your meal plan
- Cook mode — step-by-step with timers and screen lock
- "I Messed Up" — panic fix when things go wrong mid-cook
- Push notifications — meal prep reminders and perishable alerts
- Dietary profiles — audit recipes against allergies and preferences
- Nutrition estimation — per-serving breakdowns
- Cooking stats — track streaks and top recipes
- 7 themes — dark, light, OLED, and Material You (Android)
- Unit conversion — metric ↔ US

Self-hosted

No accounts required — works out of the box. Recipes stay on your server. API keys are stored as Docker secrets or environment variables, never in the database.