wmill

What it is and what it does

wmill is the official Python client for Windmill, a workflow automation platform. It wraps the Windmill server API and exposes both simple top-level functions for common operations (getting variables and resources, running scripts, managing state) and a lower-level Windmill class for direct API access via get/post methods. The library depends only on httpx for HTTP communication.

You use wmill when you need to interact with a Windmill instance from Python—either to orchestrate workflows, fetch configuration data, or integrate Windmill into a larger Python application. It's designed for both simple scripting (one-liners to fetch a variable) and complex automation (async job submission and polling).

Use it for:

• Fetch Windmill variables and resources from within a Python script or application.
• Run Windmill scripts synchronously or asynchronously and retrieve their results.
• Manage script execution state across multiple invocations.
• Build Python automation that orchestrates jobs via the Windmill API.
• Integrate Windmill workflows into a larger Python backend or data pipeline.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

wmill is a Python client library for the Windmill workflow automation platform, providing methods to access variables, resources, run scripts, and manage job state.

Yes. wmill is actively maintained (released 1 day ago), has a permissive Apache-2.0 license, minimal dependencies, and is in the top 5000 PyPI packages. Install it if you need to interact with a Windmill instance from Python. No known security vulnerabilities.

Install

wmill on PyPI

pip install wmill

uv add wmill

poetry add wmill

Installing wmill

Before you install

Active maintenance with a release 1 day old. Single dependency on httpx keeps install friction low. Supports Python 3.7 through 3.11.

License in practice

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restriction.

Quickstart

pip install wmill

import wmill

# Get a variable
value = wmill.get_variable("u/user/variable_path")

# Or use the Windmill client directly
from wmill import Windmill
client = Windmill()
result = client.run_script(path="f/pathto/script", args={"arg1": "value1"})

Requires WM_TOKEN environment variable or explicit token parameter to authenticate with a Windmill server.

Verify before relying

• Actual repository URL and commit history not provided in metadata.
• Whether the package is actively maintained by Windmill or community-driven.
• Specific API stability guarantees or breaking-change policy across versions.

Package facts

Evidence: wmill-1.789.0-py3-none-any.whl

Tags

More Distributed Computing packages