菜单
Set up and activate the TuyaOpen development environment, install system dependencies, and initialize tos.py. Use when the user mentions environment setup, activating the SDK, installing dependencies, export.sh, or when tos.py is not found. 环境搭建、环境初始化、激活开发环境、安装依赖。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/tuya/TuyaOpen-dev-skills --skill tuyaopen-env-setup命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Create new TuyaOpen projects and platforms, manage build configurations, update platform dependencies, and use tos.py subcommands. Use when the user mentions creating a project, tos.py new, saving or choosing a config, tos.py update, or general tos.py usage. 创建项目、新建工程、配置管理、保存配置、选择配置、更新依赖。
Build and compile TuyaOpen projects, select build configurations, edit Kconfig options, clean artifacts, and run Linux ELF binaries. Use when the user mentions compiling, building, tos.py build, config choice, menuconfig, Kconfig, build error, or running a project. 项目编译、构建、编译配置、清理编译、编译错误、menuconfig、Kconfig。
Send commands to the TuyaOpen device serial CLI (tal_cli) over UART and capture responses. Use when the user wants to run CLI commands on a connected T5AI, ESP32, T2, T3, or LN882H board — such as sys_reset, kv_dump, fs_ls, or custom registered commands — without opening a foreground monitor. Auto-discovers the USB serial port and platform baud rate. 设备CLI命令、串口命令、tal_cli、kv_dump、sys_reset、串口调试。
基于 SOC 职业分类
正在显示 SKILL.md
| name | tuyaopen/env-setup |
| description | Set up and activate the TuyaOpen development environment, install system dependencies, and initialize tos.py. Use when the user mentions environment setup, activating the SDK, installing dependencies, export.sh, or when tos.py is not found. 环境搭建、环境初始化、激活开发环境、安装依赖。 |
| license | Apache-2.0 |
| compatibility | ["Ubuntu/Debian with apt-get (or macOS/Windows equivalent)","Python >= 3.6","git >= 2.0, cmake >= 3.28, make >= 3.0, ninja >= 1.6"] |
Docs: https://tuyaopen.ai/docs/quick-start/enviroment-setup
| Variable | Set by activation | Meaning |
|---|---|---|
$OPEN_SDK_ROOT | yes | SDK root path |
$OPEN_SDK_PYTHON | yes | venv Python executable |
$VIRTUAL_ENV | yes | active venv path |
Linux / macOS:
if [ -n "$OPEN_SDK_ROOT" ] && [ -n "$VIRTUAL_ENV" ]; then
echo "Already activated"
else
cd "$(git rev-parse --show-toplevel)" && . ./export.sh
fi
Windows PowerShell:
if ($env:OPEN_SDK_ROOT -and $env:VIRTUAL_ENV) {
Write-Host "Already activated"
} else {
Set-Location (git rev-parse --show-toplevel); . .\export.ps1
}
Windows CMD:
if defined OPEN_SDK_ROOT if defined VIRTUAL_ENV (echo Already activated) else (
for /f "delims=" %%i in ('git rev-parse --show-toplevel') do cd /d "%%i"
call export.bat
)
Ubuntu / Debian:
sudo apt-get install lcov cmake-curses-gui build-essential ninja-build \
wget git python3 python3-pip python3-venv libc6-i386 libsystemd-dev
macOS / Windows: see official docs linked above.
Run once per terminal session from the SDK root:
. ./export.sh # Linux / macOS
.\export.ps1 # Windows PowerShell
export.bat # Windows CMD
After activation: $OPEN_SDK_ROOT, $OPEN_SDK_PYTHON, $OPEN_SDK_PIP are set; SDK root is in PATH.
tos.py version # e.g. v1.3.0-23-g6bcb5aa
tos.py check # validates tool versions + runs git submodule update --init
Or run the bundled check script:
| Platform | Command |
|---|---|
| Linux / macOS | .agents/skills/tuyaopen/env-setup/scripts/check_env.sh |
| Windows CMD | .agents\skills\tuyaopen\env-setup\scripts\check_env.bat |
| Windows PowerShell | .agents/skills/tuyaopen/env-setup/scripts/check_env.ps1 |
| Symptom | Fix |
|---|---|
python3-venv missing | sudo apt-get install python3-venv |
Activation fails, .venv/ exists | rm -rf .venv/ && . ./export.sh |
tos.py: command not found | Re-run . ./export.sh |
| Submodule download fails | git submodule update --init |
[Unknown version] | No git tags — harmless |