tinytuya
Python module to interface with Tuya WiFi smart devices
Decision gist · record as of 2026-08-14
Yes, if you own Tuya smart devices and want local control without cloud dependency. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers both local and cloud modes. Requires upfront setup (device pairing, credential retrieval) but is straightforward for developers familiar with IoT device provisioning.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Tuya devices must be activated via Smart Life App; you need device ID, IP address, local key, and protocol version (3.1–3.5) to communicate.
- Low friction install with three standard runtime dependencies (requests, colorama, cryptography).
- Active maintenance with recent releases; last commit 2026-07-19.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive) allows commercial and private use with minimal restrictions.
last release 2026-07-06 (39 days) · last repo commit 2026-07-19 · 1,704 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 687,853 downloads/mo, #5,343 on PyPI
Alternatives
Verify before relying
pip install tinytuya
import tinytuya
d = tinytuya.Device('DEVICE_ID_HERE', 'IP_ADDRESS_HERE', 'LOCAL_KEY_HERE', version=3.3)
data = d.status()
print('Device status: %r' % data)- Whether the package supports Python 2 or only Python 3 (classifiers list Python 3 but requires_python is unspecified).
- Performance characteristics when controlling many devices or polling at high frequency.
- Whether cloud connectivity requires active Tuya IoT Platform subscription or if local-only operation is always available.
What it is and what it does
TinyTuya is a Python library for controlling Tuya-compatible smart home devices—plugs, switches, lights, window covers, and similar IoT hardware—either directly over your local network or through Tuya's cloud API. It communicates with devices using Tuya Protocols 3.1 through 3.5 and serves as a replacement for the older pytuya module. The library handles device discovery via built-in network scanning, retrieves device status, and sends commands to change state or settings.
The package depends on requests for cloud operations, colorama for terminal output formatting, and cryptography for secure device communication. It can run on space-limited systems like OpenWRT routers by installing without automatic dependencies and choosing an alternative cryptography library (PyCryptodome, pyaes, or PyCrypto). Setup requires obtaining a local key for each device through Tuya's IoT platform or the built-in setup wizard, which links your Smart Life app account to retrieve device credentials.
Use it for
- Automate smart plugs and switches in a home or office without relying on cloud-only interfaces.
- Build local-network monitoring dashboards that poll device status without internet dependency.
- Integrate Tuya devices into custom home automation scripts or larger IoT orchestration systems.
- Discover and inventory Tuya devices on a network using the built-in scanner.
- Control window covers, lights, and other stateful devices programmatically from Python applications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own Tuya smart devices and want local control without cloud dependency.
The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers both local and cloud modes. Requires upfront setup (device pairing, credential retrieval) but is straightforward for developers familiar with IoT device provisioning.
Install
tinytuya on PyPI
Before you install
Low friction install with three standard runtime dependencies (requests, colorama, cryptography). Active maintenance with recent releases; last commit 2026-07-19. Supports optional cryptography alternatives (PyCryptodome, pyaes) for space-constrained systems.
Tuya devices must be activated via Smart Life App; you need device ID, IP address, local key, and protocol version (3.1–3.5) to communicate.
License in practice
MIT license (permissive) allows commercial and private use with minimal restrictions.
Quickstart
pip install tinytuya
import tinytuya
d = tinytuya.Device('DEVICE_ID_HERE', 'IP_ADDRESS_HERE', 'LOCAL_KEY_HERE', version=3.3)
data = d.status()
print('Device status: %r' % data)Verify before relying
- Whether the package supports Python 2 or only Python 3 (classifiers list Python 3 but requires_python is unspecified).
- Performance characteristics when controlling many devices or polling at high frequency.
- Whether cloud connectivity requires active Tuya IoT Platform subscription or if local-only operation is always available.
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesrequestscoloramacryptography |
| Maintenance | Actively maintained 39 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 687,853 / month, #5,343 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: tinytuya-1.20.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “tuya smart device control”
- tinytuyaControls and monitors Tuya WiFi smart devices (plugs, switches,…
- tuya-device-sharing-sdkA Python SDK for Tuya's Open API that handles IoT device management,…
- python-kasaControl TP-Link Kasa and Tapo smart home devices (plugs, switches,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also meross-iot · pywemo · tuya-device-sharing-sdk · gardena-bluetooth · python-fullykiosk · python-miio · python-tado · pyvesync · govee-ble · seam