# sd_tools

**Repository Path**: samwan_9996/sd_tools

## Basic Information

- **Project Name**: sd_tools
- **Description**: 基于 Go 语言开发的 Stable Diffusion WebUI 命令行工具集
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-15
- **Last Updated**: 2025-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Stable Diffusion 工具集 (sd_tools)

基于 Go 语言开发的 Stable Diffusion WebUI 命令行工具集。

## 当前工具

### txt2img_cli (v1.1.0)

一个基于 Go 语言实现的文本生成图像工具，通过 Stable Diffusion WebUI API 接口进行交互。

#### 主要功能

- GNU 风格的命令行界面
- 支持本地和远程 WebUI 服务器
- 多种 API 模式（WebUI+API 或仅 API）
- 支持从文件读取提示词

#### 命令行选项

支持短格式和长格式选项：

- `-v, --version`：显示版本信息
- `-i, --info`：显示当前模型信息
- `-l, --listmodels`：列出所有可用模型（当前模型用 * 标记）
- `-L, --listsamplers`：列出所有可用采样器（默认采样器用 * 标记）
- `-p, --prompt`：设置正向提示词
- `-n, --negative-prompt`：设置反向提示词
- `-P, --prompt-file`：从文件读取正向提示词
- `-N, --negative-prompt-file`：从文件读取反向提示词
- `--cfg-scale`：设置 CFG scale 值
- `--width`：设置图像宽度
- `--height`：设置图像高度
- `--api`：在 WebUI + API 模式下运行
- `--nowebui`：在仅 API 模式下运行（轻量级）

## 系统要求

- Go 1.x
- Stable Diffusion WebUI：
  - 启动时必须启用 API 功能，可以使用以下任一方式：
    * `./webui.sh --api`：同时启用 WebUI 界面和 API
    * `./webui.sh --nowebui`：仅启用 API（更轻量级）
  - 如果需要从其他机器访问，需要加上 `--listen` 参数
  - 默认端口为 7861
- 依赖项：
  - github.com/spf13/pflag

## 安装方法

```bash
# 安装依赖
go mod tidy

# 编译
go build txt2img_cli.go
```

## 使用方法

基本用法：

```bash
# 使用提示词生成图像
./txt2img_cli -p "你的提示词"

# 使用正向和反向提示词
./txt2img_cli -p "你的正向提示词" -n "你的反向提示词"

# 从文件读取提示词
./txt2img_cli -P prompt.txt -N negative_prompt.txt

# 指定输出文件名
./txt2img_cli -p "你的提示词" -o result.png

# 设置图片尺寸和 CFG Scale
./txt2img_cli -p "你的提示词" --width 768 --height 512 --cfg-scale 7.5

# 指定采样器和步数
./txt2img_cli -p "你的提示词" -r "Euler a" --steps 30

# 指定随机种子（生成可复现的结果）
./txt2img_cli -p "你的提示词" --seed 42

# 切换到其他模型
./txt2img_cli -p "你的提示词" -m "modelname_v1.0"

# 查看当前模型信息
./txt2img_cli -i

# 查看所有可用模型
./txt2img_cli -l

# 查看所有可用采样器
./txt2img_cli -L
```

## 版本历史

### v1.1.0
- 添加 GNU 风格的命令行选项
- 支持短格式和长格式选项
- 改进帮助信息显示
- 使用 spf13/pflag 标准化标志格式

### v1.0.0
- 首次发布
- 基本的文本生成图像功能
- 文件式提示词输入
- 模型和采样器信息查询
- 自定义服务器配置

## 开源协议

[待添加开源协议信息]