Skip to content
Subaya

快速开始

三步即可从零完成一次通过的仿真。suya CLI 驱动一切——同样服务于人类、AI agent 和 CI。

1. 安装 CLI

Section titled “1. 安装 CLI”
Terminal window
# macOS / Linux
curl -fsSL https://subaya-dev.com/cli/install.sh | sh
Terminal window
# Windows
irm https://subaya-dev.com/cli/install.ps1 | iex

所有平台和校验和请参见下载页面。用以下命令验证：

Terminal window
suya version

2. 登录

Section titled “2. 登录”
Terminal window
suya auth login

这会打开浏览器以授权 CLI，然后在本地存储一个令牌。对于 agent 和 CI，请改为设置 SUBAYA_API_KEY 环境变量——无需浏览器：

Terminal window
export SUBAYA_API_KEY="sk_..."
suya auth whoami

完整说明请参见认证与 API 密钥。

3. 运行你的第一次仿真

Section titled “3. 运行你的第一次仿真”
Terminal window
suya project create --name adder --workspace <workspace-id> --type fpga


suya sim run \
  --tool ryusim \
  --tb tb/adder_tb.py \
  --top adder \
  --source ./rtl \
  --wait

--source 会打包你的 RTL 树并将其发送到云端 RyuSim 运行；--wait 会轮询直到运行到达终止 状态并打印通过/失败摘要。然后：

  • suya sim report <run-id> — 结果摘要
  • suya sim logs <run-id> --follow — 流式获取运行日志
  • suya sim wave <run-id> — 定位波形产物（用 wf 分析）
  • suya sim list — 最近的运行

接下来去哪里

Section titled “接下来去哪里”