JlMoreno00/sabor

A kitchen-intelligence layer with built-in SQLite or optional Mealie/Postgres. Find or import recipes, plan the
week, build a scaled shopping list, estimate its cost, then sync to Bring! with
an explicit preview and digest-bound confirmation. The selected recipe
store is the source of truth for cooking data; core workflows work without Mealie.
Brand guide: docs/marca/.
Optional non-secret config.toml settings use environment > file > defaults.
Set SABORCONFIG to select a file; see configuration keys and OS paths.
Secrets may use environment variables or setup-managed keyring/file references;
saborcapabilities reports data.configsource. Run sabor-mcp doctor --json
to check store health, or sabor-mcp config show --json for masked values and
origins. See terminal diagnostics.
## The everyday flow
1. Call saborcapabilities(); use only tools in data.registeredtools.
2. Find recipes with searchrecipes or suggestrecipes; inspect structured
ingredients and instructions with getrecipe. Alternatively preview
importrecipe(source="https://example.org/recipe", kind="url"), ask the
user, then repeat with dryrun=False.
3. Agree a menu and use setmealplanentry for each approved entry.
4. Create or select a store shopping list, then call
addtoshoppinglist(listid="MEALIEID", mealplanstart="2026-10-19", mealplanend="2026-10-25", servingsmultiplier=2.0).
Dates are inclusive. Each recipe occurrence is added; free-text entries are
skipped with reasons. The multiplier scales native recipe yield, not a guessed
diner count. This call writes immediately: obtain approval first.
5. Reread getshoppinglistitems and estimate the actual list with
estimatecost(source={"kind":"shoppinglist","listid":"MEALIEID"}, store={"provider":"mercadona"}).
Show consumption and procurement subtotals, coverage and uncertainties. If
over budget, propose changes and obtain new approval before changing the plan.
6. Discover getshoppingsynctargets. Preview
syncshoppinglist(mealielistid="MEALIEID", target={"provider":"bring","listid":"BRINGID"}).
Show additions, removals, conflicts, skipped checked items and previewdigest.
Ask; repeat the same call with confirm=True, previewdigest="APPROVEDDIGEST".
A stale digest or any conflict blocks writes and returns a fresh preview;
review and ask again rather than blindly retrying or switching to replace.
This is documented agent orchestration, not a composite tool or transaction.
Plan → list → estimatecost → sync crosses independent approval boundaries.
List creation/additions write immediately; cost approval authorizes no purchase.
Report each system's outcome; uncertain writes require readback/reconciliation,
not automatic retries or an assumed cross-system rollback.
## Sabor solo vs Sabor + Mealie
| Capability | Sabor solo | Sabor + Mealie |
| Recipes, meal plans, shopping lists | Built-in SQLite; no account or token | Mealie URL + API token |
| URL import | Offline recipe-scrapers / JSON-LD | Native Mealie scraper |
| Text / image / video import | Optional compatible LLM / Gemini; video needs ffmpeg | Optional providers; native image import uses Mealie configuration |
| Bring! sync / Mercadona estimates | Optional credentials / pricing opt-in | Same optional integrations |