https://github.com/tuya/tuya-iot-python-sdk
Tuya IoT Python SDK for Tuya Open API.
https://github.com/tuya/tuya-iot-python-sdk
iot python sdk tuya
Last synced: 19 days ago
JSON representation
Tuya IoT Python SDK for Tuya Open API.
- Host: GitHub
- URL: https://github.com/tuya/tuya-iot-python-sdk
- Owner: tuya
- License: mit
- Created: 2021-03-26T14:17:43.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-12-23T22:50:04.000Z (over 2 years ago)
- Last Synced: 2025-04-19T18:33:49.618Z (about 1 month ago)
- Topics: iot, python, sdk, tuya
- Language: Python
- Homepage:
- Size: 319 KB
- Stars: 142
- Watchers: 27
- Forks: 55
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tuya IoT Python SDK
A Python sdk for Tuya Open API, which provides basic IoT capabilities like device management, asset management and industry capabilities, helping you create IoT solutions.
With diversified devices and industries, Tuya IoT Development Platform opens basic IoT capabilities like device management, AI scenarios, and data analytics services, as well as industry capabilities, helping you create IoT solutions.
## Features
### Base APIs
- TuyaOpenAPI
- connect
- is_connect
- get
- post
- put
- delete
- TuyaOpenMQ
- start
- stop
- add_message_listener
- remove_message_listener
### APIs
- TuyaDeviceListener
- update_device
- add_device
- remove_device
#### Device control
- TuyaDeviceManager
- update_device_list_in_smart_home
- update_device_caches
- update_device_function_cache
- add_device_listener
- remove_device_listener
- get_device_info
- get_device_list_info
- remove_device
- remove_device_list
- get_factory_info
- factory_reset
- get_device_status
- get_device_list_status
- get_device_functions
- get_category_functions
- get_device_specification
- send_commands
#### Home
- TuyaHomeManager
- update_device_cache
- query_scenes
- trigger_scene
- query_infrared_devices
- trigger_infrared_commands
#### Assets
- TuyaAssetManager
- get_device_list
- get_asset_info
- get_asset_list
## Possible scenarios
- [HomeAssistant Tuya Plugin](https://github.com/tuya/tuya-home-assistant)
- [Tuya Connector Python](https://github.com/tuya/tuya-connector-python)
- [FHEM Tuya Plugin by fhempy](https://github.com/dominikkarall/fhempy/tree/master/FHEM/bindings/python/fhempy/lib/tuya_cloud)
- ...
## Prerequisite
### Registration
Please check [Tuya IoT Platform Configuration Guide](https://developer.tuya.com/en/docs/iot/Platform_Configuration_smarthome?id=Kamcgamwoevrx) to register an account on the [Tuya IoT Platform](https://iot.tuya.com?_source=github), and get the required information. You need to create a Cloud project and complete the configuration of asset, user, and application. Then, you will get the **username**, **password**, **Access ID**, and **Access Secret**.
## Usage
## Installation
`pip3 install tuya-iot-py-sdk`
## Sample code
[OpenAPI Sample](https://github.com/tuya/tuya-iot-python-sdk/blob/master/example/device.py)
[Open IoT Hub Sample](https://github.com/tuya/tuya-iot-python-sdk/blob/master/example/mq.py)
## Tuya Open API reference
Tuya opens up a variety of APIs covering business scenarios such as device pairing, smart home management, device control, and scene automation. You can call APIs according to API integration documents to implement applications.
For more information, see the [documentation](https://developer.tuya.com/en/docs/cloud/?_source=github).
## Issue feedback
You can provide feedback on your issue via **Github Issue** or [Technical Ticket](https://service.console.tuya.com/).
## License
tuya-iot-py-sdk is available under the MIT license. Please see the [LICENSE](./LICENSE) file for more info.