Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tuya/tuya-home-assistant

Home Assistant integration for controlling Powered by Tuya (PBT) devices using Tuya Open API, maintained by the Home Assistant Community and Tuya Developer Team.
https://github.com/tuya/tuya-home-assistant

home-assistant iot mqtt-client python tuya tuya-smart

Last synced: 1 day ago
JSON representation

Home Assistant integration for controlling Powered by Tuya (PBT) devices using Tuya Open API, maintained by the Home Assistant Community and Tuya Developer Team.

Host: GitHub
URL: https://github.com/tuya/tuya-home-assistant
Owner: tuya
License: mit
Created: 2021-04-16T07:48:35.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2024-07-17T08:13:47.000Z (7 months ago)
Last Synced: 2025-01-24T02:11:18.614Z (8 days ago)
Topics: home-assistant, iot, mqtt-client, python, tuya, tuya-smart
Homepage:
Size: 1.39 MB
Stars: 891
Watchers: 49
Forks: 209
Open Issues: 555
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        [![GitHub license](https://img.shields.io/github/license/tuya/tuya-home-assistant.svg)](https://github.com/tuya/tuya-home-assistant/blob/master/LICENSE)

[![GitHub contributors](https://img.shields.io/github/contributors/tuya/tuya-home-assistant.svg)](https://github.com/tuya/tuya-home-assistant/graphs/contributors)

[![GitHub issues](https://img.shields.io/github/issues/tuya/tuya-home-assistant.svg)](https://GitHub.com/tuya/tuya-home-assistant/issues/)

[![GitHub pull-requests](https://img.shields.io/github/issues-pr/tuya/tuya-home-assistant.svg)](https://GitHub.com/tuya/tuya-home-assistant/pulls/)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

[![GitHub watchers](https://img.shields.io/github/watchers/tuya/tuya-home-assistant.svg?style=social&label=Watch)](https://GitHub.com/tuya/tuya-home-assistant/watchers/)

[![GitHub forks](https://img.shields.io/github/forks/tuya/tuya-home-assistant.svg?style=social&label=Fork)](https://GitHub.com/tuya/tuya-home-assistant/network/)

[![GitHub stars](https://img.shields.io/github/stars/tuya/tuya-home-assistant.svg?style=social&label=Star)](https://GitHub.com/tuya/tuya-home-assistant/stargazers/)

## Breaking Update:

Tuya has developed a new HA integration called [Smart Life](https://github.com/tuya/tuya-smart-life), available for free to developers. Currently in beta testing, it eliminates the need to register a cloud development project on Tuya IoT platform and extend the Tuya cloud development IoT Core Service resources when expired. This significantly lowers the access barrier and enhances user experience. If you're interested, please check the following links to get started with the integration:

- Smart Life Integration (Beta): 

- Tutorial documentation: 

- Video Tutorial: 

Key Features:

  - The new Smart Life integration is open source, allowing developers to actively contribute and maintain it.

  - Please note that the new Smart Life integration is not compatible with the existing [Tuya integration](https://www.home-assistant.io/integrations/tuya/), and device migration is not possible. Users will need to use the new plugin to add devices and configure automation scenarios.

  - The new Smart Life integration supports the same range of products as the [Tuya integration](https://www.home-assistant.io/integrations/tuya/).

  - Local control is not yet supported in the new [Smart Life Integration](https://github.com/tuya/tuya-smart-life).

# Tuya Home Assistant Integration Documentation



    



The Tuya Home Assistant integration is developed for controlling **Powered by Tuya (PBT)** devices using the [tuya-iot-python-sdk](https://github.com/tuya/tuya-iot-python-sdk?_source=df9bd859d17e7610d5b9df34d38a83e9) (a python version of [Tuya Open API](https://developer.tuya.com/en/docs/cloud/?_source=6c7c0e6d9fc9ac8296e1a48954e1d0e4)), and maintained by the official Tuya Developer Team and Home Assistant Community.

## Important Note

We are announcing that the **Tuya v2 integration** hosted on this repository is no longer maintained by the Tuya Developer Team. Only the related documentation will be provided in this repository, as shown below:

#### Installation

- [Tuya IoT Platform Configuration Guide](./docs/platform_configuration.md)

- [Install Tuya Integration](./docs/install.md)

#### Documentation

- [Error Code and Troubleshooting](./docs/error_code.md)

- [Tuya Integration FAQs](./docs/faq.md)

- [Countries/Regions and Data Center](./docs/regions_dataCenters.md)

- [Not Supported Device Category](./docs/not_supported_devices.md)

Here is the official [Tuya Home Assistant integration](https://www.home-assistant.io/integrations/tuya/).

If you want to contribute to the Tuya integration, please directly create issues or pull requests in the [Home Assistant Core repository](https://github.com/home-assistant/core/tree/dev/homeassistant/components/tuya).

If you want to contribute to the documentation, please create issues or pull requests in this repo.

We really appreciate your contributions and awesome ideas to this project.

We are happy to hear your voices at **GitHub Discussions** to make our integration better.

## Prerequisites

- Your devices need to first be added in the [Tuya Smart or Smart Life app](https://developer.tuya.com/en/docs/iot/tuya-smart-app-smart-life-app-advantages?id=K989rqa49rluq&_source=fa490bbdc25052bdf601160a53e5629c#title-1-Download).

- You will also need to create an account in the [Tuya IoT Platform](https://iot.tuya.com/?_source=a4c65f56395e05cf64cc8d4abb7396b6).

This is a separate account to the one you made for the app. You cannot log in with your app's credentials.

## Supported Tuya Device Categories

Seven primary categories, 50 secondary categories are supported now!

:clap: [Supported Device Category](./docs/supported_devices.md)

 :tada: :tada: :tada: [Vote for Tuya Integration New Device Driver Support!](https://github.com/tuya/tuya-home-assistant/discussions/86) :tada::tada::tada:

## Verified PBT Products List

If you have tested and confirmed any Tuya compatible PBT (Powered by Tuya) device, please help to contribute to [Mark Watt Tech's page](https://github.com/MarkWattTech/Tuya-v2-Supported-Devices)

It's a collection of known working PBT Products that are compatible with Home Assistant and the Tuya integration.

We appreciate your contribution!

### DISCLAIMER

[Mark Watt](https://www.youtube.com/channel/UCQRm_z7seHnGsBiWDNEWr6A) is not associated with Home Assistant or Tuya. He is a Smart Home and Home Assistant enthusiast, and would like to help make the Tuya integration the best it can be.

## Follow us

-   [Twitter](https://twitter.com/developwithtuya)

-   [YouTube](https://www.youtube.com/channel/UC25KgSG1nXMZmR8ehs3tleA)

-   [Facebook](https://www.facebook.com/Develop-With-Tuya-104216298552203)

-   [Bilibili](https://space.bilibili.com/1394005610?from=search&seid=1788260158867313813)

-   [Linkedin](https://www.linkedin.com/company/develop-with-tuya)

-   [Discord](https://discord.gg/E2Xs97N9RK)

Follow us to get more information and leading technology on the Internet of Things, as well as updates and activities on the [Tuya IoT Developer Platform](https://developer.tuya.com/?_source=6d8d369b1b09336f622047669af507c4)

## Issue Feedback

You can give feedback on issues you encounter for the documentation via **GitHub Issue**.

## Related Projects

- [Tuya IoT Python SDK](https://github.com/tuya/tuya-iot-python-sdk?_source=df9bd859d17e7610d5b9df34d38a83e9)

- [Tuya Connector Python](https://github.com/tuya/tuya-connector-python?_source=5f909fc5f4f349e687a09dc5c91bac4c)

## LICENSE

For more information, please refer to the [LICENSE](LICENSE) file.