Install the SDK
This guide will walk you through setting up Workflows and verifying your installation.
Prerequisites
Before installing the Workflows SDK, ensure you have:
Install Workflows
Install the Workflows package from PyPI using uv:
uv add mistralai-workflowsThis will create a virtual environment (if one doesn't exist) and install Workflows along with its core dependencies.
Installing with Optional Dependencies
The Mistral plugin provides native integration with Mistral's AI models and services, including durable agents, tool calling, and multi-agent handoffs:
uv add "mistralai-workflows[mistralai]"For payload offloading and direct cloud storage access from activities, install the extra for your provider:
# AWS S3 support
uv add "mistralai-workflows[s3]"
# Azure Blob Storage support
uv add "mistralai-workflows[azure]"
# Google Cloud Storage support
uv add "mistralai-workflows[gcs]"
# All storage providers
uv add "mistralai-workflows[storage]"Verify Installation
To verify your installation was successful, run the following command:
uv run python -c "import mistralai.workflows; print('Workflows is installed successfully!')"To start a new workflows project, scaffold it with the Mistral CLI: mistral workflows init <project-name> creates a project that already depends on the Workflows SDK, with a worker ready to run. See Your first workflow for the full walkthrough.