Term-SD 是一款基于 Dialog 实现前端界面显示的 AI 管理器,支持安装,管理以下软件:
- 1、Stable-Diffusion-WebUI / Stable-Diffusion-WebUI-Forge / stable-diffusion-webui-reForge / Stable-Diffusion-WebUI-AMDGPU / SD.Next
- 2、ComfyUI
- 3、InvokeAI
- 4、Fooocus
- 5、lora-scripts
- 6、kohya_ss
Term-SD 支持在 Linux,Windows,MacOS 上运行,在使用 Term-SD 前先配置好依赖环境,以下是各个平台所需的依赖:
- Windows:MSYS2,Aria2,Python,Pip,Git,Dialog,Curl,Visual C++ Runtime
- Linux:Aria2,Python,Pip,Git,Dialog,Curl
- MacOS:Homebrew,Aria2,Python,Pip,Git,Dialog,Rust,Cmake,Protobuf,Wget,Curl
Note
Python 的版本建议使用 3.9 ~ 3.11,推荐使用 3.10。这里推荐一些 Python 版本管理器。
- Pyenv(Windows 系统上使用 Pyenv-Win)
- MicroMamba
- MiniConda
在 Linux 上安装指定版本的 Python 并不方便,所以可以用上面的 Python 版本管理器安装 Python,并在启动 Term-SD 时加上--set-python-path
启动参数来指定 Python 的路径。
具体方法可参考该文档:《在 Linux 上使用 Python 版本管理器安装 Python》
!Windows 平台可阅读图文版《Windows 平台如何配置 Term-SD 运行环境》
下载 Microsoft Visual C++ Redistributable 并安装。
Note
缺失 Microsoft Visual C++ Redistributable 可能会导致 PyTorch 无法正常调用 GPU,参考:[Bug]: Missing requirement for VC_redist.x64.exe causes "RuntimeError: Torch is not able to use GPU" · Issue #16032 · AUTOMATIC1111/stable-diffusion-webui
下载 MSYS2 安装包。
下载好后打开 MSYS2 安装包,打开后点击Next
进入安装路径选择,点击Browse
选择安装路交警,选择好后点击Next
进行安装。
Note
Windows10 需在开始菜单中找到 Micorsoft Store 并进入,搜索 Windows Terminal 进行安装。
右键桌面或者文件管理器空的位置,点击在终端中打开
,在标题栏点击向下的箭头,打开 Windows 终端设置,点击添加新配置文件
。
在名称
中填入MSYS2 UCRT64
。
在命令行
填入以下内容:
C:\msys64\msys2_shell.cmd -defterm -no-start -use-full-path -here -ucrt64 -shell bash
在启动目录
勾选使用父进程目录
。
在图标
填入以下内容
C:\msys64\ucrt64.ico
Note
C:\msys64
为 MSYS2 的安装目录,根据具体安装的目录修改。
保存后生效,在标题栏点击向下的箭头就可以看到MSYS2 UCRT64
,打开后就可以下载和运行 Term-SD(一定要用在 Windows 终端 配置好的 MSYS2 UCRT64 运行 Term-SD,PowerShell 和 CMD 是没法运行 Term-SD 的)。
Note
Windows 终端默认启动 PowerShell,如果想要启动时直接启动 MSYS2 UCRT64,可以在Windows 终端设置,启动
-> 默认配置文件
,将Windows Powershell
改成MSYS2 UCRT64
,这样每次打开 Windows 终端时默认就会打开 MSYS2 UCRT64,不过 MSYS2 UCRT64 并不兼容 PowerShell 或者 CMD 的命令。
不推荐使用 MSYS2 安装程序安装的 MSYS2 UCRT64 终端。
配置好 Windows 终端后在 Windows 终端的顶栏菜单里找到MSYS2 UCRT64
,打开
在 MSYS2 UCRT64 终端输入以下内容并回车。
sed -i "s#https\?://mirror.msys2.org/#https://mirrors.tuna.tsinghua.edu.cn/msys2/#g" /etc/pacman.d/mirrorlist*
pacman -Sy
输入以下内容并回车,等待安装完成。
yes | pacman -S git mingw-w64-ucrt-x86_64-git-lfs dialog curl mingw-w64-ucrt-x86_64-aria2 mingw-w64-ucrt-x86_64-ca-certificates
这里提供两种方法进行安装。
方法1. 使用 Python 安装器
下载 Python 安装包。
下载好后打开 Python 安装包,在安装界面点击Customize installation
,然后点击Next
,勾选Add Python to environment variables
,再点击Browse
,自己选择要安装的路径,选择好后点击install
,等待安装完成。
安装结束后先不要关闭安装界面,先点击Disable path length limit
(没有该选项时则不用理会),再退出。
Note
- Python 安装器在安装 Python 时同时安装 Pip(安装选项中已默认勾选安装 Pip),所以不需要手动再去安装 Pip。
Disable path length limit
为启用 Windows 系统的长路径支持,具体查看微软官方文档《最大路径长度限制》,之前已经在 Windows 系统中启用该功能之后,选项Disable path length limit
将不会显示。
方法2. 使用命令安装
运行下面的命令下载 Python 并安装。
mkdir -p "${HOME}/python310" ; curl -L "https://modelscope.cn/models/licyks/invokeai-core-model/resolve/master/pypatchmatch/cpython-3.10.15%2B20241008-x86_64-pc-windows-msvc-shared-install_only.tar.gz" | tar -xzf - --strip-components=1 -C "${HOME}/python310"
此时 Python 将会安装到${HOME}/python310
这个路径,在启动 Term-SD这个步骤需要手动指定一下这个路径。
./term-sd.sh --set-python-path "${HOME}/python310/python"
完成上面的步骤后 Term-SD 的运行环境就配置好了,可以在下面的步骤安装 Term-SD。
sudo apt install python3 python3-pip python3-venv python3-tk git aria2 dialog curl
sudo pacman -S python3 python3-pip python3-venv tk git aria2 dialog curl
sudo zypper install python3 python3-pip python-venvs python-tk git aria2 dialog curl
nix-env -i python311Full aria git dialog curl
Note
一些 Linux 发行版没法安装指定版本的 Python,导致 Python 版本不合适,造成 AI 软件运行出错,所以可以用安装要求部分推荐的 Python 版本管理器安装 Python,并在启动 Term-SD 时加上--set-python-path
启动参数来指定 Python 的路径。
参考该教程:《在 Linux 上使用 Python 版本管理器安装 Python》
完成上面的步骤后 Term-SD 的运行环境就配置好了,可以在下面的步骤安装 Term-SD。
配置 Homebrew 镜像源 的环境变量。
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_PIP_INDEX_URL="https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
下载安装脚本并安装 Homebrew(如果下载失败可以多试几次)。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
下载成功后会自动进入安装程序,根据提示来安装,安装成功时将会提示Next steps
,根据提示执行- Run these commands in your terminal to add Homebrew to your PATH:
和- Run these commands in your terminal to add the non-default Git remotes for Homebrew/brew and Homebrew/homebrew-core:
部分的命令。
brew -v
能够正常输出 Homebrew 版本就说明安装成功。
brew update
安装 Git,Aria2,Dialog,Python,Rust,Cmake,Protobuf,Wget,Curl。
brew install git aria2 dialog [email protected] rust cmake protobuf wget curl
完成上面的步骤后 Term-SD 的运行环境就配置好了,可以在下面的步骤安装 Term-SD。
打开终端,输入以下命令下载 Term-SD。
aria2c https://github.com/licyk/term-sd/raw/main/term-sd.sh && chmod +x term-sd.sh
如果下载失败可以打开科学上网,再输入刚才的指令,或者使用 Gitee 仓库地址下载。
aria2c https://gitee.com/licyk/term-sd/raw/main/term-sd.sh && chmod +x term-sd.sh
Note
- term-sd.sh 文件所在路径决定了 Term-SD 安装路径和 Term-SD 安装 AI 软件的路径,所以要选好一个自己想要安装的路径再下载,当然也可以把 term-sd.sh 文件移到其他路径。
- Term-SD 已支持修改 AI 软件的安装路径,可以在 Term-SD 的
Term-SD 设置
->自定义安装路径
中设置,该功能的说明在《如何使用Term-SD》。
在终端输入以下命令启动 Term-SD。
./term-sd.sh
如果需要指定 Python 路径,则加上--set-python-path <Python 解释器路径>
参数进行指定,例如。
./term-sd.sh --set-python-path "${HOME}/python310/python"
启动后等待安装 Term-SD 组件后即可正常使用。
可在启动 Term-SD 时加上--quick-cmd
启动参数安装term_sd
命令和tsd
命令,使启动 Term-SD 更快捷。
更多信息请阅读帮助文档。
介绍 Windows 平台下如何配置 Term-SD 运行环境。
介绍使用 Python 版本管理器安装指定版本的 Python。
介绍 Term-SD 界面 (Dialog) 的操作方法。
介绍 Term-SD 的使用方法,包括安装,管理 AI 软件,和 Term-SD 一些功能的使用。