biniou

环境要求

• 已安装并可用的 Docker 环境
• 至少 8GB 内存（无需独立 GPU 也可运行）
• 如需 CUDA 加速，需要 NVIDIA GPU 并支持 --gpus all
• 本机 7860 端口未被占用

安装与启动步骤

1. 1准备 Docker 环境

   README 假设你已有一个配置好、可正常工作的 Docker 环境，请先确认 docker 命令可用再继续。

2. 2拉取官方镜像

   直接拉取每周更新的镜像，默认版适合无 GPU 环境；有 NVIDIA 显卡则拉取 CUDA 版。

   docker pull ghcr.io/woolverine94/biniou:main

   复制

3. 3启动容器

   启动 WebUI 并映射 7860 端口，同时挂载输出、模型、缓存和 gfpgan 四个数据卷，避免重启后数据丢失。

   docker run -it --restart=always -p 7860:7860 \
   -v biniou_outputs:/home/biniou/biniou/outputs \
   -v biniou_models:/home/biniou/biniou/models \
   -v biniou_cache:/home/biniou/.cache/huggingface \
   -v biniou_gfpgan:/home/biniou/biniou/gfpgan \
   ghcr.io/woolverine94/biniou:main

   复制

4. 4访问 WebUI

   在浏览器打开 127.0.0.1:7860 即可使用；加上 ?__theme=dark 可切换深色主题，把 127.0.0.1 换成容器 IP 也可访问。

5. 5本地安装(可选)

   不使用 Docker 时，在 macOS Intel 上先用 Homebrew 安装依赖，再克隆仓库并运行安装脚本。

   brew install git python3 gcc gcc@11 perl make ffmpeg openssl
   python3 -m pip install virtualenv
   git clone https://github.com/Woolverine94/biniou.git
   cd ./biniou
   ./install.sh

   复制

6. 6本地启动与退出

   从 biniou 目录执行 webui.sh 启动；Windows 用户双击 webui.cmd。退出时在终端按 CTRL+C。

   cd /home/$USER/biniou
   ./webui.sh

   复制

关键配置

如何确认成功

浏览器打开 127.0.0.1:7860，能看到 Gradio 的 biniou 操作界面即部署成功；加 ?__theme=dark 可验证深色主题。

常见问题

注意事项

• 首次启动会比较慢，Windows 11 上尤其明显，请耐心等待。
• 部署完成并下载好所需模型后，biniou 可离线工作。
• CUDA 版本需在 docker run 中加入 --gpus all，并在启动前确认显卡驱动和 nvidia-container-toolkit 可用。
• 除本机外，同一局域网/WiFi 内的设备（含手机）把 URL 中的 127.0.0.1 换成 biniou 主机 IP 即可访问。