Python client for Mistral REST API.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pengyuesheng d3d529f952 Modify the url of upper_constraints_file 4 weeks ago
doc Merge "Bump openstackdocstheme to 1.30.0" 1 month ago
functionaltests Add missing `--public` option to workbook api 11 months ago
mistralclient Don't use default mutable parameter 2 months ago
releasenotes Update master for stable/stein 3 months ago
tools Avoid for constraints support 1 year ago
.gitignore Switch to using stestr 1 year ago
.gitreview OpenDev Migration Patch 2 months ago
.stestr.conf Migrate python-mistralclient jobs to Zuul v3 11 months ago
.zuul.yaml Use openstack-python3-train-jobs for python3 test runtime 1 month ago
CONTRIBUTING.rst Update and optimize documentation links 2 years ago
LICENSE Moving Mistral Client code from main Mistral repository 5 years ago
README.rst Replace URLs with URLs 2 months ago
functional_creds.conf.sample Fixing launching mistralclient tests 4 years ago
lower-constraints.txt Bump openstackdocstheme to 1.30.0 1 month ago
requirements.txt Add missing oslo.serialization requirement 1 year ago Add script to run functional CLI and client tests locally 4 years ago
setup.cfg Add python 3.7 classifier to setup.cfg 1 month ago Updated from global requirements 2 years ago
test-requirements.txt Update hacking version 6 months ago
tox.ini Modify the url of upper_constraints_file 4 weeks ago


Team and repository tags



Latest Version

Mistral is a workflow service. Most business processes consist of multiple distinct interconnected steps that need to be executed in a particular order in a distributed environment. A user can describe such a process as a set of tasks and their transitions. After that, it is possible to upload such a description to Mistral, which will take care of state management, correct execution order, parallelism, synchronization and high availability.

Mistral also provides flexible task scheduling so that it can run a process according to a specified schedule (for example, every Sunday at 4.00pm) instead of running it immediately. In Mistral terminology such a set of tasks and relations between them is called a workflow.

Mistral client

Python client for Mistral REST API. Includes python library for Mistral API and Command Line Interface (CLI) library.


First of all, clone the repo and go to the repo directory:

$ git clone
$ cd python-mistralclient

Then just run:

$ pip install -e .


$ pip install -r requirements.txt
$ python install

Running Mistral client

If Mistral authentication is enabled, provide the information about OpenStack auth to environment variables. Type:

$ export OS_AUTH_URL=http://<Keystone_host>:5000/v2.0
$ export OS_USERNAME=admin
$ export OS_TENANT_NAME=tenant
$ export OS_PASSWORD=secret
$ export OS_MISTRAL_URL=http://<Mistral host>:8989/v2  (optional, by
  default URL=http://localhost:8989/v2)

and in the case that you are authenticating against keystone over https:

$ export OS_CACERT=<path_to_ca_cert>


In client, we can use both Keystone auth versions - v2.0 and v3. But server supports only v3.*

To make sure Mistral client works, type:

$ mistral workbook-list

You can see the list of available commands typing:

$ mistral --help