{"id":27313,"library":"python-mistralclient","title":"Mistral Client Library","description":"A Python client for OpenStack Mistral workflow service. Version 6.2.0, actively maintained. Releases follow OpenStack releases.","status":"active","version":"6.2.0","language":"python","source_language":"en","source_url":"https://github.com/openstack/python-mistralclient","tags":["openstack","mistral","workflow","client"],"install":[{"cmd":"pip install python-mistralclient","lang":"bash","label":"latest release"}],"dependencies":[],"imports":[{"note":"Direct import of mistralclient gives no useful symbols; must use the subpackage.","wrong":"import mistralclient","symbol":"client","correct":"from mistralclient.api import client"},{"note":"","wrong":"","symbol":"MistralClient","correct":"from mistralclient.api.client import MistralClient"}],"quickstart":{"code":"from mistralclient.api import client\nmistral = client.client(mistral_url='http://localhost:8989/v2', username='admin', password='pass', project_name='admin', auth_url='http://localhost:5000/v3')\nworkflows = mistral.workflows.list()\nprint(workflows)","lang":"python","description":"Initialize the client and list workflows. Adjust auth parameters per your OpenStack setup."},"warnings":[{"fix":"Always use keyword arguments when creating the client: `client.client(mistral_url=..., username=...)`.","message":"From version 4.0.0, the authentication interface changed. The old `client.client(...)` no longer accepts positional arguments for auth parameters; all must be passed as keyword arguments.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Use `from mistralclient.api import client` and then `c = client.client(...)`.","message":"The `client.client()` factory function returns an instance of `MistralClient`, but the class is also importable directly. However, using the factory is recommended because it handles version discovery and auth setup.","severity":"gotcha","affected_versions":"all"},{"fix":"Use Python 3.10 or newer (as of 6.2.0).","message":"Support for Python 2.7 was dropped in version 4.0.0. Also, Python 3.6 support ended in 5.0.0.","severity":"deprecated","affected_versions":">=4.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Upgrade to latest version: `pip install --upgrade python-mistralclient`","cause":"Installed older version (<2.0) where package structure was different.","error":"mistralclient.api.client module not found"},{"fix":"Use `from mistralclient.api import client`","cause":"Trying to import mistralclient directly instead of mistralclient.api.","error":"AttributeError: module 'mistralclient' has no attribute 'api'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}