siliconflow/bizyair-cli

siliconflow/bizyair-cli

Language: Go

Stars: 1

Forks: 1

Open issues: 0

Created: 2025-04-07T08:17:15Z

Pushed: 2026-06-05T12:03:57Z

Default branch: main

Fork: no

Archived: no

README: BizyAir CLI

BizyAir CLI 是一个开源命令行工具，您可以从 GitHub 获取最新版本。

简介

BizyAir CLI 是用于管理 BizyAir 上模型文件的命令行工具。它提供了交互式界面（TUI）和命令行（CLI）两种使用模式，让您可以轻松上传和管理 BizyAir 模型。

✨ 核心特性

• 🎨 交互式 TUI 界面 - 友好的图形化交互体验，无需记忆命令
• 🚀 断点续传 - 上传中断后自动从断点继续，节省时间
• ⚡ 并发上传 - 最多 3 个并发，显著提升上传速度
• 📦 分片上传 - 大文件（>100MB）自动分片上传，更稳定
• 🖼️ 智能封面处理 - 自动转换为 WebP 格式，支持图片和视频
• 📝 灵活的介绍输入 - 支持直接输入或从文件导入（.txt/.md）
• 📋 YAML 批量上传 - 通过配置文件一次上传多个模型
• 🌐 VPN 检测 - 自动检测 VPN 并给出友好提示
• 📊 实时进度显示 - 上传速率、进度条实时更新
• 🔄 自动升级 - 一键升级到最新版本，支持版本检查和安全回滚

发布版本

所有发布版本请点击这里查看。

安装

BizyAir CLI 支持 Linux、macOS 和 Windows 平台。所有平台的二进制文件都可以从 GitHub Release 页面 下载。

Linux 安装

1. 从 Release 页面 下载最新版本：

# 设置版本号（请替换为最新版本）
VERSION=0.2.1

# 下载 Linux amd64 版本
wget https://github.com/siliconflow/bizyair-cli/releases/download/v${VERSION}/bizyair-v${VERSION}-linux-amd64.tar.gz

# 或下载 Linux arm64 版本
# wget https://github.com/siliconflow/bizyair-cli/releases/download/v${VERSION}/bizyair-v${VERSION}-linux-arm64.tar.gz

2. 解压并安装：

# 解压文件
tar -xzvf bizyair-v${VERSION}-linux-amd64.tar.gz

# 安装到系统路径
sudo install bizyair /usr/local/bin/bizyair

# 或者安装到用户目录（无需 sudo）
# mkdir -p ~/.local/bin
# install bizyair ~/.local/bin/bizyair
# 确保 ~/.local/bin 在您的 PATH 中

3. 验证安装：

bizyair --version

macOS 安装

1. 从 Release 页面 下载最新版本：

# 设置版本号（请替换为最新版本）
VERSION=0.2.1

# 下载 macOS arm64 版本（Apple Silicon，如 M1/M2/M3）
curl -LO https://github.com/siliconflow/bizyair-cli/releases/download/v${VERSION}/bizyair-v${VERSION}-macos-arm64.tar.gz

# 或下载 macOS amd64 版本（Intel 芯片）
# curl -LO https://github.com/siliconflow/bizyair-cli/releases/download/v${VERSION}/bizyair-v${VERSION}-macos-amd64.tar.gz

2. 解压并安装：

# 解压文件
tar -xzvf bizyair-v${VERSION}-macos-arm64.tar.gz

# 添加执行权限
chmod +x bizyair

# 安装到系统路径
sudo install bizyair /usr/local/bin/bizyair

# 或者安装到用户目录（无需 sudo）
# mkdir -p ~/.local/bin
# install bizyair ~/.local/bin/bizyair
# 确保 ~/.local/bin 在您的 PATH 中

3. 首次运行时，macOS 可能会提示安全警告，请按以下步骤操作：

# 移除隔离属性
sudo xattr -d com.apple.quarantine /usr/local/bin/bizyair

或者在系统设置中允许运行：

• 打开 系统设置 → 隐私与安全性
• 找到被阻止的 bizyair 并点击 仍要打开

4. 验证安装：

bizyair --version

Windows 安装

1. 从 Release 页面 下载最新版本：

• 下载 bizyair-v{VERSION}-windows-amd64.zip 文件

2. 解压文件：

• 右键点击下载的 .zip 文件
• 选择 解压全部 或使用解压工具（如 7-Zip）
• 将 bizyair.exe 解压到您选择的目录（例如 C:\Program Files\BizyAir\）

3. 添加到系统 PATH（推荐）：

• 右键点击 此电脑 → 属性 → 高级系统设置
• 点击 环境变量
• 在 系统变量 中找到 Path，点击 编辑
• 点击 新建，添加 bizyair.exe 所在的目录路径
• 点击 确定 保存

4. 验证安装：

打开 命令提示符 或 PowerShell：

bizyair --version

如果没有添加到 PATH，可以使用完整路径运行：

C:\Program Files\BizyAir\bizyair.exe --version

从源码构建

BizyAir CLI 当前使用 GO v1.22.X 或更高版本。 要从源码构建，您需要：

1. 克隆仓库 2. 构建并运行可执行文件

make build && ./execs/bizyair

• Windows 系统运行：make build_windows
• MacOS 系统运行：make build_mac
• Linux 系统运行：make build_linux 或 make build_linux_arm64

---

使用模式

BizyAir CLI 提供两种使用模式，您可以根据自己的喜好选择：

🎨 交互式界面（TUI）- 推荐新手使用

直接运行 bizyair 命令即可进入友好的交互式界面：

bizyair

TUI 模式特点：

• ✅ 图形化界面，操作直观
• ✅ 逐步引导，不易出错
• ✅ 实时反馈和进度显示
• ✅ 支持文件选择器
• ✅ 自动 VPN 检测和提示

⌨️ 命令行模式（CLI）- 适合脚本和自动化

使用命令行参数直接执行操作：

bizyair upload -n mymodel -t LoRA -p /path/to/model.safetensors -b "Flux.1 D" -cover /path/to/cover.jpg

CLI 模式特点：

• ✅ 快速执行，适合脚本
• ✅ 支持 YAML 批量上传
• ✅ 可集成到 CI/CD 流程
• ✅ 支持环境变量配置

---

升级到最新版本

BizyAir CLI 支持一键升级到最新版本：

# 检查更新
bizyair upgrade --check

# 执行升级
sudo bizyair upgrade

---

快速开始

方式一：使用交互式界面（推荐）

1. 启动 TUI

bizyair

2. 首次使用需要登录

• 输入您的 API Key（从 BizyAir 获取）
• 按 Enter 确认

3. 选择功能

• 上传模型：交互式收集参数并上传
• 我的模型：在浏览器中查看已上传的模型
• 退出登录：清除本地 API Key
• 退出程序

4. 上传模型

• 按照界面提示逐步输入信息
• 支持文件选择器或手动输入路径
• 支持多版本上传
• 自动显示上传进度和速率

方式二：使用命令行

1. 登录

BizyAir CLI 使用 API Key 进行身份验证。要登录您的设备，运行以下命令：

# 如果您已设置环境变量 SF_API_KEY
bizyair login

# 或使用 --key/-k 选项指定
bizyair login -k $SF_API_KEY

2. 上传模型

单版本上传示例：

bizyair upload -n mymodel -t LoRA \
-p /local/path/model.safetensors \
-b "Flux.1 D" \
-cover "/path/to/cover.jpg" \
--intro "这是一个动漫风格的 LoRA 模型"

多版本上传示例：

bizyair upload -n mymodel -t Checkpoint \
-v "v1.0" -p /path/file1.safetensors -b SDXL --intro "第一版" -cover "/path/cover1.jpg" \
-v "v2.0" -p /path/file2.safetensors -b "SD 1.5" --intro "第二版" -cover "/path/cover2.jpg"

核心参数说明：

• -n, --name: 模型名称（必填）
• -t, --type: 模型类型（必填，如 LoRA、Checkpoint、Controlnet 等）
• -p, --path: 模型文件路径（必填，可多次指定）
• -b, --base: 基础模型（必填，如 "Flux.1 D"、SDXL、"SD 1.5" 等）
• -cover: 封面文件或 URL（必填）
• -i, --intro: 模型介绍文本（必填）
• --intro-path: 从文件导入介绍（与 -i 二选一）
• -v, --version: 版本名称（可选，默认 v1.0）
• --public: 是否公开版本（可选，默认 false）

3. 封面上传（必填）

封面支持本地文件和 URL 两种方式，会自动上传到 OSS 并转换为 WebP 格式：

# 使用本地文件
bizyair upload -n mymodel -t LoRA -p model.safetensors -b "Flux.1 D" \
-cover "/path/to/cover.jpg" --intro "介绍文本"

# 使用 URL
bizyair upload -n mymodel -t LoRA -p model.safetensors -b "Flux.1 D" \
-cover "https://example.com/cover.jpg" --intro "介绍文本"

支持的格式：

• 图片：.jpg、.jpeg、.png、.gif、.webp
• 视频：.mp4、.webm、.mov（最大 100MB）

WebP 转换： 图片封面会自动转换为 WebP 格式以优化加载速度。如果转换失败，会自动回退到原始格式。

4. 介绍文本输入

支持两种方式输入模型介绍（最多 5000 字）：

# 方式1：直接输入文本
bizyair upload -n mymodel -t LoRA -p model.safetensors -b "Flux.1 D" \
-cover cover.jpg --intro "这是模型的详细介绍..."

# 方式2：从文件导入（支持 .txt 和 .md）
bizyair upload -n mymodel -t LoRA -p model.safetensors -b "Flux.1 D" \
-cover cover.jpg --intro-path intro.md

5. YAML 批量上传

使用 YAML 配置文件可以一次上传多个模型：

bizyair upload -f config.yaml

YAML 配置示例：

models:
- name: "anime_style_lora"
type: "LoRA"
versions:
- name: "v1.0"
base_model: "Flux.1 D"
model_path: "models/anime_v1.safetensors"
cover_path: "covers/anime_v1.jpg"
intro: "第一版动漫风格模型"
public: true

- name: "v2.0"
base_model:…