Deployments

A deployment is a running instance of your workflow workers registered with the Workflows platform. When you start a worker, it connects to the platform, registers its workflows and activities, and starts polling for tasks. There is no separate registration step — everything is handled automatically at startup.

import asyncio
import mistralai.workflows as workflows


@workflows.activity()
async def my_activity(data: str) -> str:
    return f"processed: {data}"


@workflows.workflow.define(name="my_workflow")
class MyWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, data: str) -> str:
        return await my_activity(data)


async def main():
    await workflows.run_worker([MyWorkflow])


if __name__ == "__main__":
    asyncio.run(main())

import asyncio
import mistralai.workflows as workflows


@workflows.activity()
async def my_activity(data: str) -> str:
    return f"processed: {data}"


@workflows.workflow.define(name="my_workflow")
class MyWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, data: str) -> str:
        return await my_activity(data)


async def main():
    await workflows.run_worker([MyWorkflow])


if __name__ == "__main__":
    asyncio.run(main())

MISTRAL_API_KEY=your_key uv run python my_workflow.py

MISTRAL_API_KEY=your_key uv run python my_workflow.py

Workers are stateless and interchangeable — any worker that has registered a workflow can execute it. To increase throughput, run multiple workers with the same code and API key. Tasks are automatically distributed across all available workers.

MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Worker 1
MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Worker 2
MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Worker 3

MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Worker 1
MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Worker 2
MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Worker 3

For environment separation, use different workspaces:

MISTRAL_API_KEY=dev_key  uv run python my_workflow.py  # Dev
MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Production

MISTRAL_API_KEY=dev_key  uv run python my_workflow.py  # Dev
MISTRAL_API_KEY=prod_key uv run python my_workflow.py  # Production