Skip to main content

Learn

Learn

Hands-on, user-facing guidance for TuyaOpen — pick your board, set up the IDE, learn the SDK, and follow along with projects, tutorials, and guides.

All

37 guides

Basics

3 guides

Quick takeaways and fundamentals — the essential concepts, tools, and tips to get moving with TuyaOpen.

tyutool — flashing & authorization guide

Install tyutool, flash your first board, authorize it for Tuya IoT, and fix common hiccups (GUI + CLI).

Get a license key

Understand TuyaOpen authorization and how to obtain UUID / AuthKey credentials for your devices.

Use your license key

Write the UUID + AuthKey to a device with tyutool (GUI + CLI), then verify it activates against the Tuya Cloud.

TuyaOpen IDE

7 guides

Build firmware, cloud Agents, and app panels from one AI-driven workspace with Vibe Coding.

What is TuyaOpen IDE

Understand TuyaOpen IDE — the AI-era embedded dev environment where you describe a device in natural language and the Agent generates firmware, configures the cloud, and wires up the app.

Install TuyaOpen IDE

Install the TuyaOpen IDE extension in VS Code or Cursor — via an AI coding agent or the manual .vsix — then verify it is enabled.

Beginner · 5 minOpen

Practice 1: Hello World

Run an official example with zero code and learn the core IDE chain — pick board, build, flash, and read logs.

Beginner · 15 minOpen

Practice 2: your_chat_bot

Build the classic AI + IoT project end-to-end — create, build, flash, authorize, and pair — the cloud IoT / AI Agent flow in the IDE.

Intermediate · 20 minOpen

Practice 3: mini-app panel

Build a device control panel that runs in the phone app and cooperates with firmware over DP — create, bind, preview, and publish.

Intermediate · 20 minOpen

Vibe Coding skills

Copy-paste prompts for the skills that install inside TuyaOpen IDE — hardware peripherals, IoT products, platform ops, build/flash/debug, and panels.

Agent Development Guide

Complete end-to-end workflow for developing, deploying, and binding TuyaOpen IoT Agents across device and cloud using the TuyaOpen IDE.

Beginner · 15 minOpen

TuyaOpen SDK

5 guides

The toolchain workflow — set up the environment, build firmware, flash, monitor, and pair a device.

Set up your development environment

Install the TuyaOpen toolchain, clone the repo, and activate tos.py — the one command every later step uses.

Beginner · 10 minOpen

Build your first firmware

Configure switch_demo for your board with tos.py config choice, then compile it into a flashable bin with tos.py build.

Beginner · 8 minOpen

Flash and monitor your device

Write the built bin to the board with tos.py flash, then watch it boot with tos.py monitor — both from the project directory.

Beginner · 8 minOpen

Pair your device with the SmartLife app

Put a flashed, authorized device into pairing mode and register it to the Tuya IoT Cloud — the last step to a device you control from your phone.

Beginner · 6 minOpen

tos.py command reference

An interactive reference for every tos.py subcommand — pick one to see its signature, a real example, and when to use it.

IntermediateOpen

Community

22 guides

Projects built by the TuyaOpen community — robots, wearables, edge AI, and more.

Otto Ninja — Open-Source Dual-Mode Robot

Build a 3D-printed robot that walks and races on wheels, driven by TuyaOpen with voice control and a GC9D01 display.

T5-Pocket — Your AI+IoT Companion

Carry a pocket-sized AI+IoT host running TuyaOpen: multimodal chat, audio/video, and a virtual pet.

LED Pixel Art Light Matrix

Drive a 16x16 LED matrix from the TuyaOpen SDK with 8 animation modes and real-time color control.

AI Chatbot on T5AI-Core

Stand up an AI chatbot on T5AI-Core with an ST7789 screen, live emotion display, and voice I/O.

Simple Cloud-Connected Switch

Wire up a TuyaOpen switch you can control from the app, with secure cloud authentication.

Custom Fonts in LVGL

Set local and global fonts in LVGL, change the default, and add custom icon glyphs for embedded UIs.

Custom Wake Words with T5 + 2M-ASR-PRO

Add offline speech recognition to a T5 board with custom wake words and multi-role support.

Star Tracker — Astronomical Compass

Point a T5AI-Core + T5-E1 module at the stars and chat with an astronomy agent.

Dynamic Light-Effect Glasses

Turn heartbeat and music rhythm into visible light flowing through a wearable frame.

CyberPlant — Plant NFT

A blockchain plant-NFT project with a frontend, backend API, and smart contracts.

Auraflow — Focus Companion Robot

A pomodoro companion robot that nudges deep-focus users toward scientific breaks.

TuyaOpen on RDK-X5

Run TuyaOpen's multimodal agent on RDK-X5's local NPU for edge AI + IoT.

Soccer Star — Spherical Robot

A self-balancing ball-shaped robot that rolls itself toward the goal.

Smart Social Badge

A wearable that flashes the same light as a nearby stranger who shares your interests.

Community

OpenClaw Desktop Pet

Pixel side-scroller on an embedded device whose characters react to OpenClaw server status over TCP/MQTT. — by 王劣劣

Community

Verdure Buddy Desktop Ornament

A desktop ornament on the Tuya T5 board running a full DuckyClaw. — by 绿荫阿广

Community

Win95-style OS on T5

A Windows 95-style embedded desktop simulator on the TuyaOpen T5 AI board. — by 福杰

Work Buddy Desktop Assistant

A desktop assistant on a Tuya AI board with screen, mic, speaker, and camera, backed by the Tuya Cloud. — by 陈瑞

Community

DuckyClaw Voice-Controlled Smart Car

Voice-control an ESP32 smart car from a Tuya T5 AI board — the AI parses natural language and sends HTTP commands to drive. — by 贾献华

Zodiac E-Paper Screen

A 4-inch E6 color e-paper display on Tuya T5AI hardware that generates zodiac imagery with AI. — by 乔楚

Community

E-Paper Reader on T5AI-Board

An e-paper reader with SD-card browsing, text/image viewing, orientation switch, and NTP — paper-like static display. — by 贾献华

Ported Games on T5AI-Board

Five classic games (Plants vs Zombies, 2048, etc.) ported to the Tuya T5AI-Board with LVGL touch interaction. — by 大树