---
id: wmill
version: "1.789.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# wmill — A client library for accessing Windmill server wrapping the Windmill client API

License: permissive · Maintenance: active · Downloads: 867.0K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 867.0K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

windmill client library, workflow automation python, windmill api wrapper, script execution client, job state management, workflow-automation, api-client

[View on SkillFed](https://skillfed.io/packages/wmill) · [View on PyPI](https://pypi.org/project/wmill/)