gotailwind

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 on this page — 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

gotailwind on PyPI

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

Evidence: gotailwind-0.4.0-py3-none-any.whl

Keywords: api, async, client, garage, garage-door, gotailwind, home-assistant, iq3, smart-home, tailwind

Tags

More Python Modules packages