必须使用Python 3.11：因SunoAI依赖GTK绑定，3.12+版本会静默失败且不可降级；需通过Scoop安装python@3.11、supabase-cli等工具，并手动配置GTK路径C:\GTK\bin至系统PATH，再用Poetry锁定3.11环境执行poetry install与supabase start。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Windows 上为 SunoAI 配置开发环境，需绕过手动安装 GTK、Supabase CLI、Python 版本冲突等高频报错环节，直接构建可运行代理服务的最小可行环境。
安装基础工具链
以管理员身份运行 PowerShell，依次执行以下命令：
1. 安装 Scoop（若未安装）：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser; irm get.scoop.sh | iex
2. 通过 Scoop 安装关键依赖：scoop install git python@3.11 nodejs-lts docker-desktop supabase-cli
3. 安装 Visual Studio Build Tools（必须）：访问 Visual C++ Build Tools 官网 下载离线安装器，勾选“使用 C++ 的桌面开发”工作负载 → 安装完成后重启终端。
【Python 必须锁定为 3.11】 后续 Poetry 环境初始化会因 3.12+ 不兼容 GTK 绑定而静默失败，且无法通过 pip downgrade 修复。
配置 GTK 与系统路径
方法一：手动部署（推荐，可控性强）
1. 访问 GTK Win32 Releases，下载最新 gtk4-x64-*.zip（非 MSYS2 版）
2. 解压到 C:\GTK（路径不能含空格或中文）
3. 将 C:\GTK\bin 添加进系统环境变量 PATH —— 这一步漏掉会导致 ImportError: DLL load failed while importing cairo
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
方法二：用 Chocolatey（仅当已装）：choco install gtk4-runtime，但需手动验证 cairo.dll 是否在 PATH 可见范围内。
初始化 SunoAI 项目环境
第一步：克隆仓库并进入目录
git clone https://github.com/suno-ai/suno.git && cd suno
第二步：创建 Poetry 虚拟环境
poetry env use python3.11 && poetry install
第三步：配置 Supabase 本地连接
运行 supabase start，等待输出 Local development setup is ready! 后，复制终端中显示的 anon key 和 project url，粘贴进项目根目录下的 .env 文件对应字段。
第四步：启动后端服务
poetry run python app.py —— 若控制台出现 Uvicorn running on http://0.0.0.0:8000 即表示服务已就绪。
