Skip to main content



Taq run is used to execute a script using TzCompose, a powerful automation framework developed by Blockwatch for executing complex transaction sequences on Tezos. This task allows you to run custom scripts that interact with the Tezos blockchain, perform various operations, and automate complex workflows.

In order to use run, you need to have the TzCompose plugin installed in your Taqueria project. For additional details, please see the TzCompose plugin documentation.


taq run <scriptPath>

Task Details

Task NameCommandTypeDescription
runtaq run <scriptPath>Plugin - TzComposeRuns a script using TzCompose

Command-Line Arguments

ArgumentRequiredDescriptionExample Usage
<scriptPath>YesThe path of the script to run using TzComposetaq run ./scripts/deploy.yaml


-e, --envSpecify an environment configuration
-v, --verbosityVerbose level (1-3)


To run a script using TzCompose, navigate to your Taqueria project directory and execute the following command:

taq run <scriptPath>

Replace <scriptPath> with the path to your TzCompose script file (e.g., ./scripts/deploy.yaml).

You can optionally specify an environment configuration using the -e or --env flag, which allows you to customize the behavior of your script based on different environments (e.g., development, staging, production).

The -v or --verbosity flag allows you to control the verbosity level of the output. You can provide a value from 1 to 3, with 1 being the least verbose and 3 being the most verbose.

For detailed information on creating YAML files to define your TzCompose scripts, please refer to the TzCompose documentation.


To run a script located at ./scripts/deploy.yaml:

taq run ./scripts/deploy.yaml

To run a script with a specific environment configuration:

taq run ./scripts/deploy.yaml --env production

To run a script with increased verbosity:

taq run ./scripts/deploy.yaml --verbosity 3