Ocipe is a digital personal cookbook with a built-in grocery planner, built to make the whole cooking-and-shopping process genuinely easier. If you’ve ever found yourself scrolling through 50+ saved recipes scattered across browser bookmarks, food apps, screenshots, and group chats — only to give up and order takeout — Ocipe was built for you. Everything lives in one place: your recipes, your fridge inventory, and your weekly grocery plan, all talking to each other so nothing falls through the cracks.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/viet2811/ocipe/llms.txt
Use this file to discover all available pages before exploring further.
Cookbook
Add, search, and manage all your personal recipes in one place.
Fridge
Track what ingredients you currently have on hand.
Grocery Planner
Pick recipes for the week and get an automatic shopping list.
API Reference
Explore the Django REST Framework API powering Ocipe.
Cookbook
Your cookbook is where every recipe lives. The idea is simple: write your recipes down once, and Ocipe does the heavy lifting from there on out. You are the manager and the writer — and thanks to AI autofill and import/export, “writing them down” can be nearly instant. Each recipe stores exactly the fields you need and nothing you don’t:| Field | Description |
|---|---|
name | The recipe’s name. |
meat_type | A free-form category field — use it for meat type, meal time (breakfast/lunch/dinner), cuisine, or anything else that helps you sort and search. |
longevity | How long the recipe lasts — interpret this as portions or days, whichever makes sense for that dish. |
frequency | One of weekday, weekend, or rarely. weekday means it’s quick enough for a busy evening; weekend means it takes more time and effort; rarely means it’s a treat or a special occasion dish. |
note | Your personal notes and cooking instructions (optional). |
state | Either active (not yet planned this cycle) or used (already planned). Helps you avoid cooking the same thing twice in a row. |
ingredients | A list of ingredients, each with a name and an optional quantity. Quantity is intentionally free-form — write "2 tbsp", "a handful", or leave it blank entirely. |
meat_type or search by ingredient. Don’t want to buy anything new? Find every recipe you can cook with what’s already in your fridge.
Grocery Planner
Planning meals for a whole week — and buying only what you need — is genuinely hard to do in your head. The Grocery Planner breaks it into three simple steps:- Stock your fridge. Tell Ocipe what ingredients you already have. The fridge inventory is used to subtract items from your grocery list automatically, so you never buy something you already own.
- Pick your recipes. Select the dishes you want to cook this week. Not sure what to pick? Hit the randomizer for indecisive moments — it’ll suggest recipes from your cookbook so you don’t have to choose.
- Get your grocery list. Ocipe combines the ingredient lists from every selected recipe, cross-references your fridge, and produces a clean list of only what you actually need to buy.
Key features
AI Autofill with Gemini
Paste any recipe URL and Google Gemini automatically fills in the name, category, ingredients, and notes — no manual typing required.
Export & Import recipes
Export your full recipe list and share it with anyone. Import a friend’s export to instantly populate your own cookbook.
Fridge inventory
Keep a live record of what’s in your fridge, organized by ingredient group. Used by both the recipe search and the grocery planner for accurate results.
Smart grocery list
Generated automatically from your planned recipes minus whatever is already in your fridge. No duplicate items, no guesswork.
Search by ingredients
Type a few ingredients (comma-separated) and instantly see the closest recipes you can cook — great for using up what’s about to go off.
Recipe status tracking
The
state field (active / used) lets you track which recipes have been planned recently, so you always know what’s fresh in rotation.