Methodology
How Harmony scores food
Every product and meal in Harmony gets a score from 1 to 100 using Food Compass 2.0, a nutrient-profiling system developed at Tufts University's Friedman School of Nutrition Science and Policy and published in Nature Food in 2024. The higher the score, the healthier the food.
Food Compass looks at the whole food rather than one nutrient at a time. Tufts states that the algorithm can be freely reproduced by anyone; Harmony implements it as published and applies it to the products you scan and the meals it plans.
What the score means
Harmony uses Tufts' own three bands and labels:
Foods to eat freely and build meals around.
Foods to eat in moderation.
Foods to eat rarely.
What goes into the score
Food Compass 2.0 rates 54 attributes of a food, grouped into 9 domains. Everything is measured per 100 calories, so a snack-size portion and a family-size portion of the same food score the same.
| Domain | What it looks at |
|---|---|
| Nutrient ratios | Unsaturated to saturated fat, fiber to carbohydrate, and potassium to sodium. |
| Vitamins | Twelve vitamins, including A, C, D, E, K, folate and B12. The five strongest count. |
| Minerals | Calcium, iron, magnesium, potassium, zinc, selenium and others; sodium counts against the food. The five strongest count. |
| Food ingredients | Credit for fruits, non-starchy vegetables, beans, whole grains, nuts and seeds, seafood, yogurt and plant oils. Penalties for refined carbohydrates (including added sugar) and red or processed meat. |
| Additives | Added sugar, nitrites from cured meats, and five additives: artificial sweeteners, flavors or colors; partially hydrogenated oils; interesterified or hydrogenated oils; high-fructose corn syrup; and MSG. |
| Processing | The NOVA processing level (from minimally processed to ultra-processed), plus credit for fermentation and a penalty for frying. |
| Specific lipids | Cholesterol, medium-chain fats, plant omega-3 (ALA) and seafood omega-3 (EPA and DHA). |
| Fiber and protein | Grams of fiber and protein per 100 calories. |
| Phytochemicals | Flavonoids and carotenoids. |
The domain totals are added together (specific lipids and phytochemicals at half weight) and placed on the 1–100 scale exactly as the paper describes.
How a scanned product is scored
- Read the label. Harmony takes the nutrition facts and ingredient list from Open Food Facts, plus extra vitamin and mineral values from USDA FoodData Central when available.
- Find the closest USDA food. The product is matched to the most similar of the 6,150 foods in the USDA Food and Nutrient Database for Dietary Studies that Tufts published scores for, by product type first and then by name. Drinks are only ever matched to drinks.
- Fill the gaps. Every value printed on the label is used as-is. Values labels don't carry, such as flavonoids or most vitamins, are estimated from the matched USDA food, scaled to the product's calories.
- Score it. The processing level comes from Open Food Facts when known, otherwise from the matched USDA food, and additives are read from the ingredient list.
The app shows which USDA food was used and which values were estimated, so you can see exactly how each score was reached. If a product has no calories listed and no trustworthy match, Harmony shows no score rather than a guess.
How a meal is scored
Each ingredient is measured at a standard serving, using the FDA's Reference Amounts Customarily Consumed (21 CFR 101.12): for example 85 g of fish or chicken, 140 g of cooked rice or fruit, 85 g of vegetables and 1 tablespoon of oil. The ingredients are added together and the whole meal is scored as one food.
Meal plans only use meals that score 65 or higher, and processed meats such as bacon and sausage are never offered.
What isn't scored
- Alcoholic drinks. Food Compass does not rate them.
- Infant formula and baby food. Food Compass does not rate them.
- Products with almost no calories (under 5 calories per 100 g), such as water, plain tea and diet sodas. Because the score is per 100 calories, it isn't meaningful for them.
These products show "not scored" with the reason, and a product that can't be scored is never recommended as an alternative.
Flags shown next to the score
Some things families care about aren't part of Food Compass. Harmony shows them as separate flags so the score itself stays the published method:
- Organic or Non-GMO, and labeled as containing GMOs.
- Often high in pesticide residue unless organic, for crops such as strawberries, spinach, kale, apples, grapes, peaches, potatoes, rice and oats.
- Seed oils, naming which ones (canola, soybean, corn, sunflower, safflower, cottonseed and others).
- Contains a benzoate preservative, or benzoate with vitamin C, a combination that can form benzene.
Your family's health conditions, allergies and sensitivities are checked separately too, and any conflict is named on the product.
How closely our scores match Tufts'
Tufts published Food Compass 2.0 scores for thousands of USDA foods. We checked Harmony's scorer against 6,148 of them, using the same USDA data Tufts used:
1.55 points
Average difference from the published score, on the 1–100 scale.
66% within 1 point
Two of every three foods land within one point of Tufts' number.
94% within 5 points
Almost every food lands within five points.
Where the paper leaves a detail open to more than one reading, Harmony uses the reading that best reproduces Tufts' published scores. The check is re-run automatically every time the app's code changes.
Scores for packaged products depend on what the label and ingredient list show, so they can differ from a lab analysis, and manufacturers change recipes. Always read the label yourself, especially for allergies.
Source
Barrett EM, Shi P, Blumberg JB, O'Hearn M, Micha R, Mozaffarian D. Food Compass 2.0 is an improved nutrient profiling system to characterize healthfulness of foods and beverages. Nature Food 5, 911–915 (2024). doi:10.1038/s43016-024-01053-3
Harmony Food Agent is independent and is not affiliated with or endorsed by Tufts University or the USDA.
Not medical advice. Food Compass scores describe the overall healthfulness of a food for the general population. They are not a diagnosis or a treatment plan. Talk to your doctor or a registered dietitian about your own needs.