Pixelle-Video 的详细部署教程。这是一个全自动短视频生成引擎，只需输入主题即可生成完整视频。

本教程将覆盖Windows一键整合包、源码安装、Docker部署等多种方式，以满足不同用户的需求。

📥 方式一：Windows一键整合包（最推荐）

这是为Windows用户设计的开箱即用方案，无需安装Python、uv或ffmpeg。

  1. 下载与解压：从项目的 Releases 页面 或指定网盘下载最新的Windows整合包，然后解压到本地文件夹。
  2. 启动程序：进入解压后的文件夹，双击运行 start.bat 脚本。系统会自动启动Web界面，并弹出浏览器窗口。
  3. 访问与配置：浏览器会自动打开 http://localhost:8501。首次使用时，展开「⚙️ 系统配置」面板，必须填写LLM API密钥（如通义千问、DeepSeek等），并根据需要配置图像/视频生成服务（如ComfyUI、RunningHub或直连API）。
  4. 开始创作：配置保存后，在左侧栏输入视频主题，点击「🎬 生成视频」即可。

🐍 方式二：从源码安装（适合macOS/Linux或开发者）

这种方式适合熟悉Python环境的用户，可进行更灵活的定制。

1. 环境准备

  • 安装 Python 包管理器 uv：参考 uv官方安装指南 进行安装。
  • 安装 ffmpeg（视频处理必需）：
    • macOS: brew install ffmpeg
    • Ubuntu/Debian: sudo apt update && sudo apt install ffmpeg
    • Windows: 从 ffmpeg.org 下载，并将 bin 目录添加到系统 PATH 环境变量。

2. 获取代码与启动

1
2
3
4
5
6
# 克隆仓库
git clone https://github.com/ATH-MaaS/Pixelle-Video.git
cd Pixelle-Video

# 使用 uv 运行 Streamlit 应用（uv会自动安装所有Python依赖）
uv run streamlit run web/app.py

首次运行时会自动安装依赖。启动成功后，在浏览器打开 http://localhost:8501 即可访问Web界面。

🐳 方式三：使用Docker部署（适合服务端）

对于希望在服务器上统一部署或隔离环境的用户，项目提供了Docker支持。

  1. 准备配置文件：在项目根目录下，复制 config.example.yaml 为 config.yaml，并根据你的需求（如LLM API密钥）进行编辑。

  2. 启动容器：在项目根目录下运行以下命令：

    1
    docker-compose up -d

    该命令会构建镜像并启动容器。服务启动后，通过 http://<你的服务器IP>:8501 访问Web界面。

⚙️ 核心配置说明（所有方式通用）

无论通过哪种方式部署，首次使用时都必须在Web界面完成以下核心配置：

  • LLM 配置（必填）：用于生成文案。可选择通义千问、GPT、DeepSeek 等，并填入对应的 API Key 和 Base URL。
  • 图像/视频生成配置（至少选其一）：
    • 本地 ComfyUI：填写本地 ComfyUI 服务地址（如 http://127.0.0.1:8188），利用本地GPU生成素材（免费，推荐）。
    • 云端 RunningHub：填写 API Key，使用云端算力。
    • 直连 API 模型：配置 DashScope、OpenAI、Kling 等供应商的密钥，直接调用其图像/视频生成服务。
  • TTS 语音配置：选择合适的语音合成工作流（如 Edge-TTS），并可上传参考音频进行声音克隆。

💡 关键要点与提示

  • 免费运行方案：LLM 使用本地 Ollama + 图像使用 本地 ComfyUI，可以实现完全免费运行。
  • 费用考量：使用云端API（如通义千问、OpenAI）会产生相应费用，但成本相对可控；使用本地ComfyUI则无额外费用。
  • 模板与自定义：项目内置了丰富的视频模板（templates/ 文件夹），你也可以修改或创建自己的HTML模板来定制视频风格。
  • 故障排查：
    • 确保 ffmpeg 已正确安装并添加到系统PATH。
    • 检查ComfyUI服务地址和端口是否正确，并确保其已启动。
    • 查看终端输出的日志，可以快速定位API密钥错误或网络连接问题。