---
id: gotailwind
version: "0.4.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# gotailwind — Asynchronous Python client for Tailwind garage door openers.

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

## What it is and what it does

gotailwind is an async Python library that lets you control Tailwind smart garage door openers programmatically. It wraps the Tailwind device API, allowing you to query door status, send open/close commands, and monitor multiple doors on a single device. The package depends on aiohttp for HTTP communication, mastering for serialization, orjson for fast JSON parsing, and zeroconf for device discovery on your network.

The library is designed for integration into home automation systems and third-party applications. It includes a standalone CLI tool (via the `[cli]` extra) that exposes the same functionality from the command line, making it useful both as a library and as a standalone utility. Your Tailwind device must run firmware v10.10 or later to be compatible.

Use it for:

- Integrate garage door control into a Home Assistant or other home automation platform.
- Build a custom Python script to automate garage door operations based on time, location, or events.
- Query door status from a monitoring application to track whether doors are open or closed.
- Use the CLI tool to manually control or check status of Tailwind devices from shell scripts or cron jobs.
- Develop a web dashboard or mobile app backend that communicates with Tailwind devices on your network.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asynchronous Python client for controlling and monitoring Tailwind garage door openers over the network, with both programmatic and CLI interfaces.

Yes. The package is actively maintained, has no known vulnerabilities, installs cleanly with low friction, and is licensed permissively. Install it if you own a compatible Tailwind device and need programmatic control or CLI access. Verify that your device firmware meets the v10.10 minimum requirement before relying on it.

## Install

pip install gotailwind
uv add gotailwind
poetry add gotailwind

## Installing gotailwind

Before you install: Low friction install with a pure-Python wheel. Active maintenance with a recent release (109 days ago) and current commit activity. Requires Python 3.11 or later.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.

Quickstart:

import asyncio
from gotailwind import Tailwind

async def main():
    async with Tailwind(host="192.168.1.123", token="YOUR_TOKEN") as tailwind:
        status = await tailwind.status()
        print(f"Device ID: {status.device_id}")

asyncio.run(main())

Requires a Tailwind device on your network with firmware v10.10 or later and a valid authentication token from the device.

Verify before relying:

- Whether the package works with Tailwind devices other than the iQ3 model listed as tested.
- Whether the CLI tool requires additional system dependencies beyond what pip installs.
- Scope and maturity of error handling for network timeouts or device communication failures.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tailwind garage door control, async garage door opener api, smart home garage automation, tailwind iq3 python client, garage door status monitoring, home automation garage door, tailwind device integration, smart-home, garage-door, async-client

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