Cookwala

The open standard for cooking safely: people, kitchens and robots.

A Cookwala recipe says three things a machine can check: what to make, when it's done, and what must never happen. Devices dry-run a recipe before heating anything and refuse rather than guess; safety limits are enforced on the device and cannot be raised by any recipe, agent or message; records are hashed and signed; AI agents act only under a signed mandate and treat all text as data. A Humanitarian Profile lets food banks rescue surplus food safely by SMS and spreadsheet, with no personal data. A Household Context Profile keeps a home's facts at home.

Mission: help end hunger, make people healthier, and put robots to work for people. Hunger has many causes; Cookwala's part is real and partial: less waste, safer rescue, cheaper and healthier meals, machines that can feed people who cannot cook for themselves, and food organizations acting as one network. Evidence, with labels, is in docs/IMPACT.md.

Cookwala started as "the world's first and largest robot cooking recipes index and CLI", from one family's Egyptian recipes on fifi.cooking. The index and the CLI are here; "first" and "largest" were the original ambition, not claims; not a claim. Everything is open, royalty-free, model-neutral and device-neutral.

Status: Core 0.2 is a draft under public review; everything else is a draft or experimental profile. Live at cookwala.ai. Nothing is deployed in the field yet.

Feature status (Core 0.2, MCP server 0.3.0)

Start here

Checks

python -m venv .venv && .venv/bin/pip install jsonschema pyyaml graphql-core cryptography
.venv/bin/python tools/validate_specs.py      # schemas, examples, vocabularies, facet registry, APIs
.venv/bin/python tools/run_conformance.py     # 137 vectors (Core and profiles); --report writes a ConformanceReport
.venv/bin/pip install -e sdk/python           # the `cookwala` command used in the table above
node sim/run.mjs                              # the four simulators
bash tools/build_site.sh _site                # the website

A recipe step, the Cookwala way

{
  "id": "n11", "op": "cw.op.simmer", "inputs": ["eggs_in_wells"], "output": "shakshuka",
  "params": { "heat": "low", "lid": "on" },
  "until": { "all": [ { "vision": "cw.sense.egg_whites_set" },
                      { "sensor": "cw.sense.core_temp", "target": "egg_white", "gte": 63, "optional": true } ],
             "minTime": "PT5M", "maxTime": "PT10M" },
  "onTimeout": "ask_human", "ccp": "ccp_eggs", "hazards": ["hz_steam"], "attention": "monitor"
}

Backlog

Proposed changes, ideas from outside feedback and open questions, with an id per item for anyone to pick up or argue with: BACKLOG.md.

Licenses

• Schemas, tools, SDKs, reference implementations: Apache-2.0
• Specification text and docs: CC BY 4.0 for reuse of the text; participation, contributions and patent terms under the Community Specification License 1.0 (SCOPE.md, NOTICES.md, contributor agreement)
• Vocabularies, bindings, policy packs: CC0 1.0
• Recipe data: CC BY 4.0 where marked in each document's license field; collections whose rights are not yet confirmed carry LicenseRef-source-credited and publish structured facts only (LICENSES/LicenseRef-source-credited.md)
• Patent pledge: PATENTS.md

Cookwala is started and operated by fifi.cooking. fifi.cooking is open source too (MIT License): a static React, TypeScript, Vite and Tailwind CSS site on GitHub Pages, with native apps for Android, iPhone and iPad, Apple TV, Fire TV and Samsung TV that read its open JSON files. How it is built. Cookwala data is provided without warranty. Device makers and operators are responsible for safe execution and for complying with local law.