Skip to main content
Learn

Learn

Hands-on material for TuyaOpen: two quick-start tracks to a first working device, plus tutorials and community projects grouped by topic.

Quick start

Both tracks cover the same ground, environment setup through to a paired device. They differ in method: a graphical workflow, or the command line.

  1. TuyaOpen IDE

    Graphical development environment

    9 steps~1h 45m

    Board catalogue, one-click build and flash, and an AI agent spanning all three surfaces: firmware, cloud agent, and app panel. Suited to a first encounter with TuyaOpen.

    1. 01What TuyaOpen IDE is5 min
    2. 02Install the IDE5 min
    3. 03Practice 1: Hello World15 min
    4. 04Practice 2: your_chat_bot20 min
    5. 05Practice 3: mini app panel20 min
    6. 06Practice 4: Hello World on Linux15 min
    7. 07Vibe Coding skills10 min
    8. 08Agent development guide15 min
    9. 09IDE log feedback
    Start with the IDE

  2. TuyaOpen SDK

    Command line and toolchain

    9 steps~1h 45m

    Follows the docs' own nine-step Getting Started: environment, build, flash, authorize and pair, through to product development and OTA.

    1. 01Unboxing5 min
    2. 02Environment setup20 min
    3. 03Build project10 min
    4. 04Flashing and logging10 min
    5. 05Authorize devices10 min
    6. 06Pair with a phone10 min
    7. 07Device debugging10 min
    8. 08Tuya product development15 min
    9. 09Firmware upgrade15 min
    Start with the CLI

Tutorials and community projects

41 guides

Basics

3 guides

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

Basics

tyutool — flashing & authorization guide

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

FlashingCLI
Beginner · 8 minOpen
Basics

Get a license key

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

Setup
Beginner · 3 minOpen
Basics

Use your license key

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

SetupFlashing
Beginner · 5 minOpen

TuyaOpen IDE

8 guides

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

TuyaOpen IDE

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.

Beginner · 5 minOpen
TuyaOpen IDE

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.

Setup
Beginner · 5 minOpen
TuyaOpen IDE

Practice 1: Hello World

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

Setup
Beginner · 15 minOpen
TuyaOpen IDE

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.

Setup
Intermediate · 20 minOpen
TuyaOpen IDE

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.

Setup
Intermediate · 20 minOpen
TuyaOpen IDE

Practice 4: Linux board Hello World

Deploy the simplest Hello World to a Linux board (Raspberry Pi) from the IDE — build, deploy over SSH, and run. The cross-deploy workflow for Linux targets.

Setup
Intermediate · 15 minOpen
TuyaOpen IDE

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.

Beginner · 10 minOpen
TuyaOpen IDE

Agent Development Guide

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

Setup
Beginner · 15 minOpen

TuyaOpen SDK

7 guides

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

TuyaOpen SDK

Set up your development environment

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

SetupCLI
Beginner · 10 minOpen
TuyaOpen SDK

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.

CLI
Beginner · 8 minOpen
TuyaOpen SDK

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.

FlashingCLI
Beginner · 8 minOpen
TuyaOpen SDK

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.

Setup
Beginner · 6 minOpen
TuyaOpen SDK

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.

CLI
IntermediateOpen
TuyaOpen SDK

Build your_chat_bot from the CLI

Configure and compile the AI chatbot app with tos.py — the same voice assistant the IDE builds, driven from the command line.

CLI
Intermediate · 15 minOpen
TuyaOpen SDK

Build an AI Agent on the cloud console

Create and configure an Agent on the Tuya AI platform — models, prompts, workflows, and voices — without the IDE.

Setup
Advanced · 20 minOpen

Tutorials

1 guide

Focused how-tos for specific tasks, peripherals, and techniques.

Tutorials

Hands-On: Build MCP Skills That Let AI Control Real Devices

Create hardware MCP skills (tool functions) that let an AI agent control physical devices — build an AI Smart Oven from scratch with TuyaOpen's MCP function-call framework.

Intermediate · 30 minOpen

Community

22 guides

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

Community

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.

Open
Community

T5-Pocket — Your AI+IoT Companion

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

Open
Community

LED Pixel Art Light Matrix

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

Open
Community

AI Chatbot on T5AI-Core

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

Open
Community

Simple Cloud-Connected Switch

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

Open
Community

Custom Fonts in LVGL

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

Open
Community

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

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

Open
Community

Star Tracker — Astronomical Compass

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

Open
Community

Dynamic Light-Effect Glasses

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

Open
Community

CyberPlant — Plant NFT

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

Open
Community

Auraflow — Focus Companion Robot

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

Open
Community

TuyaOpen on RDK-X5

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

Open
Community

Soccer Star — Spherical Robot

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

Open
Community

Smart Social Badge

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

Open
Community

OpenClaw Desktop Pet

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

DetailsSource
Community

Verdure Buddy Desktop Ornament

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

DetailsSource
Community

Win95-style OS on T5

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

DetailsSource
Community

Work Buddy Desktop Assistant

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

Source
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 贾献华

DetailsSource
Community

Zodiac E-Paper Screen

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

Source
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 贾献华

DetailsSource
Community

Ported Games on T5AI-Board

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

Source