How SupperScout Works

SupperScout answers one question: given what's already in your kitchen, what's the best thing you can cook right now? It is not a recipe search engine and not a chatbot. You give it ingredients and constraints; it gives you one decision.

What you tell it

Start by typing the ingredients you actually have — chicken breast, rice, half an onion, that can of tomatoes. The tool matches your words against a curated list of 300+ common ingredients, so "chicken breasts" and "scallions" resolve to the right thing, and non-food items are rejected outright. Then you set constraints: how much time you have (15–60 minutes), how many servings, diet (vegetarian, vegan, halal, gluten-free, dairy-free), any of the Big Nine allergies to avoid, a cuisine preference, and what equipment you can use. A "use only what I have" mode forbids the tool from assuming you'll buy anything.

How the recommendation is selected

The system asks an AI model to propose exactly one recipe that uses as much of your ingredients as possible within your constraints — correct servings, total time inside your limit, only your equipment, diet strictly honored. It may list up to three missing ingredients (each a common grocery item, each with a reason), or none at all in strict-pantry mode. You can ask for another dish, make it faster, make it less spicy, or swap any ingredient for a tested substitute — and the recipe is rewritten around the change.

The part the AI doesn't control: validation

Here's what makes SupperScout different from asking a chatbot for a recipe. Before you ever see the result, deterministic code — not the AI — verifies it:

• Food safety: for recognized ingredients covered by its temperature rules, the code adds the relevant official USDA/FSIS temperature note to the recipe. It also checks generated instructions for a defined set of unsafe raw-food and undercooking patterns and rejects recipes that match those checks; the patterns cannot detect every unsafe instruction.
• Allergens: every ingredient is checked against a code-owned Big Nine map. If you flagged a peanut allergy and the recipe contains peanut, it never renders — the system regenerates or refuses instead.
• Coherence: servings must match exactly, time must add up and fit your limit, quantities must be sane, every listed ingredient must actually be used, and no unavailable equipment may be required.
• Honesty filters: the validator screens generated text against defined banned-claim patterns for medical and health claims and nutrition numbers, and rejects matches.

If the recipe fails validation, the system tries again with feedback about what went wrong — at most twice. If it still can't produce something that passes those checks, it tells you honestly instead of showing you a failed-validation recipe. And if your ingredients genuinely can't make a meal, it says that too, rather than inventing nonsense.

What it doesn't do

SupperScout doesn't plan your week, track nutrition, remember your pantry, or replace your judgment. Recipes are AI-generated and not reviewed by a human. Think of it as a decisive sous-chef for the 5pm question — fast, practical, and safety-checked — not as an authority. Read more in About SupperScout.