Clone this repo:
  1. 91f81ea [tricium] Add `run_legacy` option to skip emitting comments by Oliver Newman · 3 days ago main master
  2. 9e296d9 Set step end_time to start_time if it is earlier than the start_time by Yiwei Zhang · 8 days ago
  3. 3e3066d Do not open $debug until the engine is committed to running the step. by Robert Iannucci · 2 weeks ago
  4. e9c8ffe cq: Expose method for setting reuse by Yiwei Zhang · 3 weeks ago
  5. 3faa1ba cq: Use proto Output properties in cq recipe_module by Yiwei Zhang · 3 weeks ago


Recipes are a domain-specific language (embedded in Python) for specifying sequences of subprocess calls in a cross-platform and testable way.

They allow writing build flows which integrate with the rest of LUCI.

Documentation for the recipe engine (including this file!). Take a look at the user guide for some hints on how to get started. See the implementation details doc for more detailed implementation information about the recipe engine.


  • Sign the Google CLA.
  • Make sure your and are configured in git config.

Run the following to setup the code review tool and create your first review:

# Get `depot_tools` in $PATH if you don't have it
git clone $HOME/src/depot_tools
export PATH="$PATH:$HOME/src/depot_tools"

# Check out the recipe engine repo
git clone $HOME/src/recipes-py

# make your change
cd $HOME/src/recipes-py
git new-branch cool_feature
# hack hack
git commit -a -m "This is awesome"

# This will ask for your Google Account credentials.
git cl upload -s -r
# Wait for approval over email.
# Click "Submit to CQ" button or ask reviewer to do it for you.
# Wait for the change to be tested and landed automatically.

Use git cl help and git cl help <cmd> for more details.