企业官网建设流程全解析

Pixelle-Video 安装指南：AI 短视频引擎的 3 条部署路径，30 分钟跑通

【免费下载链接】Pixelle-Video🚀 AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video

Pixelle-Video 是一个 AI 全自动短视频引擎：给它一个主题，它会自动完成文案、画面、配音到成片的全流程。这篇 Pixelle-Video 安装指南只回答一个问题——你该走哪条路。三条路（Windows 整合包 / 源码 / Docker）装完是同一个产品，区别只在「谁来伺候你的环境」。

一、30 秒选型：三条路径哪条是你的

先对号入座，再往下翻对应章节，别三条路都装一遍。

三条路对硬件的要求几乎一样：

• Python：建议直接用 3.11+。文档写「3.10 及以上」，但 pyproject.toml 里requires-python = ">=3.11"是打包阶段的硬约束，整合包与 Docker 镜像也都是 3.11，统一用 3.11 能少走弯路。
• 操作系统：Windows / macOS / Linux 全支持。
• 包管理器：uv（推荐，更快）或 pip。
• GPU（可选）：只有当你想本地跑 ComfyUI 做图像/视频生成时才需要，建议 NVIDIA 显卡、显存 ≥6GB；用云端服务（RunningHub）或直接 API 的话，核显都行。
• 网络：要能访问 LLM 与图像生成 API。国内网络有现成的镜像开关，后面每条路都会讲。

二、路径 A：Windows 开箱即用（整合包）

整合包的设计目标就一个词：零安装。Python、uv、ffmpeg 全部打进包里，解压目录建议避开中文和空格。

拿到手先做什么：四步启动

1. 去项目 Release 页下载最新的 Windows 整合包 ZIP；
2. 解压到任意目录（路径不含中文与空格）；
3. 双击start.bat；
4. 浏览器自动打开http://localhost:8501，看到界面即成功。

首次使用只需进「⚙️ 系统配置」把 API 密钥填上。启动器底层做的事你可以放心略过：它会把内嵌 Python（python\python311）和tools\ffmpeg\bin加进PATH，设好PYTHONPATH与PIXELLE_VIDEO_ROOT后执行python -m streamlit run web\app.py，失败时暂停窗口方便你看到报错。

包里都有啥：目录速览

构建产物位于dist/windows/，解压后大致长这样：

同目录还有.zip归档和.sha256校验文件，PowerShell 里跑Get-FileHash xxx.zip -Algorithm SHA256比对一下即可确认下载完整。

想自己打包？构建参数要点

在仓库里执行python packaging/windows/build.py即可重新构建，加--cn-mirror走清华 PyPI 镜像加速（国内强烈建议）。参数由 构建配置 控制，常用项：

完整说明见 Windows 打包文档。

三、路径 B：源码级部署（macOS / Linux / 深度定制）

要改代码、跑测试、或者你就是想在 macOS 上用，走源码这条路。

拉取与装依赖

git clone https://gitcode.com/GitHub_Trending/pi/Pixelle-Video cd Pixelle-Video

uv 轨（推荐）：uv 是 Rust 写的包管理器，比传统 pip 快得多，还会自动建虚拟环境：

# 没装 uv 的话先装 curl -LsSf https://astral.sh/uv/install.sh | sh # 在项目目录同步依赖 uv sync

根目录的 uv.lock 锁定了全部依赖版本，保证你装出来和团队/生产环境一致。

pip 轨：

python -m venv venv source venv/bin/activate # Windows 用 venv\Scripts\activate pip install -e .

依赖装了啥：一张表看懂

pyproject.toml 的依赖正好覆盖了 AI 视频生产的完整链路，按职责归类：

开发依赖跑pip install -e ".[dev]"安装，含pytest、pytest-asyncio、ruff，用于测试与代码检查。

两条启动脚本的差别

仓库根目录给了两个入口，里面执行的都是uv run streamlit run web/app.py，区别在适配平台与失败处理：

所以如果你在 Windows 上裸跑源码包报错了，那是预期行为，脚本会告诉你下一步该干嘛。

四、路径 C：Docker 一条命令上生产

服务器部署直接用仓库自带的 Dockerfile + docker-compose.yml，api 与 web 双服务一条命令拉起。

镜像里预置了什么

• 基础镜像python:3.11-slim；
• apt 安装curl（健康检查）、ffmpeg（音视频处理）、fonts-noto-cjk（中文渲染）；
• 构建参数USE_CN_MIRROR（默认false）：置true时自动切阿里云 apt 源 + 清华 PyPI 镜像，专为国内构建准备；
• uv run playwright install --with-deps chromium预装模板渲染所需无头浏览器；
• 暴露8000（API）与8501（Web）两端口，默认命令uv run python api/app.py。

compose 编排：三个服务各管一摊

启动就两行：

# 国际环境（默认） docker-compose up -d # 国内环境（构建自动走清华镜像） USE_CN_MIRROR=true docker-compose up -d

一个高频细节：容器内要访问宿主机上的 ComfyUI，comfyui_url别填127.0.0.1——Mac/Windows 宿主机用host.docker.internal:8188，Linux 宿主机填宿主机 IP。

五、进阶：把「生成」搬回本地（ComfyUI 自托管 vs 云端）

前面装的都是「壳」，真正决定画面从哪来的是图像/视频生成服务。两条路线的取舍：

走本地的话，把 ComfyUI 跑起来即可（源码获取见 ComfyUI 官方说明）：

# 安装依赖 pip install -r requirements.txt # 启动服务（默认 http://127.0.0.1:8188） python main.py

ComfyUI 需要自行下载模型文件才能出活，模型清单与放置位置参考其官方文档。之后在「⚙️ 系统配置」里把 ComfyUI 地址填上，工作流切到selfhost/前缀即可。

六、装完 ≠ 能用：启动验证 + 首份配置

验证安装：看到界面才算成功

# uv 轨（无需手动激活虚拟环境） uv run streamlit run web/app.py # pip 轨（需先激活虚拟环境） streamlit run web/app.py

浏览器打开http://localhost:8501出现 Pixelle-Video 界面，说明环境没问题。

首份配置：密钥才是启动键

Pixelle-Video 的能力全部由 API 密钥驱动，配置逻辑在 pixelle_video/config/loader.py：启动时读config.yaml，文件不存在会记一条警告并回退到默认空配置；Web 界面「⚙️ 系统配置」页保存时通过save_config_dict()写回config.yaml（UTF-8、保留中文与键顺序）。

config.example.yaml 已内置一批可直接抄的预设：

• LLM：通义千问qwen-max、OpenAIgpt-4o、DeepSeekdeepseek-chat、Ollama 本地llama3.2（http://localhost:11434/v1，免费）；
• 直接 API Provider：api_providers段内置 openai、dashscope（通义）、ark、kling 四家。

所以装完后的正确姿势是：先读 配置说明 把 LLM 和图像/视频服务配好（LLM 推荐千问预设，性价比合适；图省心得用 Ollama 本地跑），再进 快速开始。

七、踩坑急救站

问：Windows 下双击start.bat报错就退，为什么？答：多半是你直接拿源码包在跑。源码包不含 Python 环境，这正是脚本故意拦下来的场景。两条路：换 Release 页的一键整合包；或者按提示装 uv、执行uv sync后再跑。

问：国内装依赖慢到想卸载，怎么办？答：三条路各有各的镜像开关——Docker 构建加USE_CN_MIRROR=true；Windows 整合包构建加--cn-mirror；源码安装自行配置 PyPI 镜像源。

问：Web 界面能打开，但一点生成就失败？答：九成是密钥没配或 ComfyUI 地址不可达。回「⚙️ 系统配置」页测连接，本地 ComfyUI 默认http://127.0.0.1:8188，Docker 场景记得改用host.docker.internal:8188（Mac/Windows）或宿主机 IP（Linux）。

问：config.yaml丢了，程序是不是废了？答：不会。程序会回退默认配置并打印警告，手动把config.example.yaml复制一份改名即可。注意这文件含 API 密钥，千万别提交进 Git——整合包构建时的排除清单里也专门挡着它。

八、通往第一个视频

到这里，环境、密钥、生成服务都就位了，剩下的是创作的事：打开 快速开始，输入你的第一个主题，让 Pixelle-Video 把文案、画面、配音、成片一口气跑完。中途想换风格、换配音，回 配置说明 和 FAQ 里找答案即可。

【免费下载链接】Pixelle-Video🚀 AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video