Skip to content

Latest commit

Β 

History

298 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation


Cuicuit

Your favorite kitchen companion!

Hero

Warning

🐣 Cuicuit just hatched! Expect alpha-quality with many bugs and rough edges. Feedback is appreciated!

Note

Self-hostable deployment coming soon! I am actively stabilizing the app foundations and hosted version first. No releases yet, but you can try the hosted version and give feedback in the GitHub discussions.

Focus on meals, not ingredients. Cuicuit does the thinking for you!

Import recipes from anywhere and get an automatic shopping list from your plan. Coming soon: it will passively learn your habits, and serve up recipe ideas for the week or right before your food expires.

πŸ₯ P.S. cui-cui is how we write the sound of a bird in French (aka. chip-chip) and cuit means to cook. French people often say c'est cuit meaning it's ready, now we can all say c'est cuicuit!

πŸ€ Why use Cuicuit?

Here is what Cuicuit aims to be once grown up:

  • Intuitive: Drag recipes into your plan and watch your shopping list update.
  • Discreet: Minimizes clicks by guessing habits and automating things.
  • Complete: Recipes, plans, lists, pantry, nutrition, product scanning, sharing, and more.
  • Self-hostable: Cuicuit is open-source. Use the hosted version if you prefer.
  • Open: Freely export your data & connect to services via APIs, MCP, and CLI.

✨ Features

Today, Cuicuit is in its early alpha stage. Here are the current features:

  • Recipe gallery: Import recipes from websites, and AI auto-fills the missing details.
  • Derived shopping list: A list appears and suggests you past purchases.
  • Shared households: Create spaces and invite your friends.
  • Mobile-friendly: Install the PWA web app on your phone.

πŸ—ΊοΈ Roadmap

This roadmap presents a rough evolution plan of Cuicuit. Your feedback is very welcome, I hope to make Cuicuit useful to everyone! Vote for features to help adjust the roadmap and prioritize the most important features.

Click to expand. Items marked with 🚧 are currently in progress:

πŸ₯š Chapter 0: Open source & Project foundations 🚧
  • 🚧 Hosted version
    • Publicly hosted version for testing and feedback
    • Basic multi-user support with isolated spaces
    • Crowd-funded moneypot to share LLM and hosting costs
    • ToS, Privacy, Cookies banners, and GDPR compliance
  • Self-hosted version
    • Dockerized deployment & documentation
    • Automated database migrations on startup
    • Embed & update ingredient images in docker
    • Automated backup and restore of database and media files
  • Documentation
    • Usage documentation for end-users
    • Technical architecture documentation for devs
  • Technical
    • Translate app & docs
    • Real-time & partial offline tolerance with a sync engine (PowerSync/Zero, TBD)
  • Open questions
    • How much offline-capable should the app be?
    • Is a PWA enough or should we build a native app?
🐣 Chapter 1: Import recipes, plan meals, get shopping lists 🚧
  • Shared households

    • Create one or more isolated "home" spaces (e.g., Home, Parents' house)
    • Share spaces with other users to collaborate
    • Invite users to your spaces
  • Recipe engine

    • Import recipes from common websites or create your own
    • Convert ingredient quantities and units
    • Organize recipes in shareable cookbooks
    • Robust recipe import from social media, photos, text, and other apps.
  • Basic meal planning

    • Simple dateless meal plan
    • Add additional ingredients & custom items
  • Shopping list generation

    • Automatically generate a shopping list
    • Suggest items based on past purchases
    • Sort & group items by aisle, meal, or cart status
  • Make this foundation great before the next step

πŸ₯ Chapter 2: Meal recommendations from your pantry
  • Pantry management
    • Add pantry items with categories, quantities, expiration dates, and storage locations
    • Import pantry items from receipts, supermarket APIs, or smart scales
    • Quantity tracking with automatic unit conversions
    • Expiration dates estimation and reminders
  • Closing the loop: Pantry-Meal-Grocery Reservation Engine
    • Connect pantry directly to planned meals and automatically reserve items for each meal
    • Adapt the grocery list based on pantry availability and reserved items
    • Show "cookability" state for each recipe
    • Suggest substitutions for missing ingredients
πŸ“ Chapter 3: Quality-of-life features to gain time
  • Contextual & Predictive Pantry Rules
    • Set "Minimum Quantities" per item to auto-trigger shopping list additions regardless of meal plan
    • Consumption habits and pantry probabilities (e.g. assume 100g of cereal daily for breakfast)
  • Smart Recipe Recommendations
    • Quick-scale party filters (e.g., "Ideas for (-) 2 (+) people")
    • Contextual badges for recipe matches: Ready to Cook, Change of Plans, or Groceries Needed
    • Reason-based suggestion badges (e.g., "Uses up items about to expire")
    • Top-of-page interactive assistant recommending tailored search filters
  • Timeline & Stats
    • Past: View everything you cooked, bought, and consumed
    • Future: Step through your planned timeline to view calculated future pantry states
    • Time travel: Select a position between planned meals to see if a cookable meal fits
    • Stats: Cooking habits, nutrition, spending, waste, sustainability, ...
  • TODO History & Undo, LLM Assistant, Nutrition Stats, Sustainability Metrics, Local Producer Sourcing...
πŸ¦… Chapter 4: Future potential and ideas
  • Supermarket mode
    • Barcode scanning while shopping: nutrition insights, past purchases, price comparisons
  • Streamlined Inventory Inputs
    • Manual slider adjustments
    • Text & image-based input processing (Groceries receipt scanning / OCR parsing)
    • Direct supermarket API inventory loading
    • Explicit "Mark recipe as cooked" triggers to batch-decrement inventory
  • Probabilistic Inventory Tracking
    • Support quantity variance ranges (e.g., tracking "1-2 onions" instead of exact grams)
    • Habit-based predictive quantity engine derived from historical data
    • Periodic low-friction micro-checkins asking users to quickly verify true quantities
  • The Autonomous Kitchen Wizard
    • Continuous, algorithmic meal plan pre-filling based on learned user profiles
    • Soft-ui states: Display suggestions as half-faded layouts for swift confirm/switch/remove interactions
    • Profile toggles: Familiar vs. Discover balancing, Flexitarian settings, and Mood adjustments
    • Kill-switch toggle to fully disable auto-filling behaviors

πŸ’Œ Contributions

Cuicuit is built and maintained in my free time. I’d love to keep improving it and make it useful for more people. If you like the project and want to help it grow, your support makes a real difference ❀️

Contributors will appear here!

About

Think about meals, not ingredients. Simply jot down meal ideas & things you're missing, and get a convenient ready-to-shop list. Self-hostable & hosted versions. More to come! πŸ₯

Topics

Resources

Stars

12 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages