Pixelle-Video 安装图文教程

# Pixelle-Video 安装图文教程

## 前置环境依赖

在开始之前，需要安装两个必要工具：

### 1. 安装 uv（Python 包管理器）

uv 是一个快速的 Python 包管理器。

**macOS / Linux**
“`bash
curl -LsSf https://astral.sh/uv/install.sh | sh
“`

**Windows**
下载安装包：https://astral.sh/uv/install.sh

验证安装：
“`bash
uv –version
“`

### 2. 安装 ffmpeg（视频处理工具）

**macOS**
“`bash
brew install ffmpeg
“`

**Ubuntu / Debian**
“`bash
sudo apt update
sudo apt install ffmpeg
“`

**Windows**
1. 下载地址：https://ffmpeg.org/download.html
2. 解压后将 bin 目录添加到系统环境变量 PATH

验证安装：
“`bash
ffmpeg -version
“`

## 安装方式一：Windows 一键整合包（推荐新手）

### 步骤 1：下载整合包
访问 GitHub Releases 页面，下载最新的 Windows 一键整合包

### 步骤 2：解压运行
1. 解压下载的 zip 文件
2. 双击运行 `start.bat`
3. 浏览器自动打开 http://localhost:8501

### 步骤 3：配置 API
1. 展开「⚙️ 系统配置」面板
2. 配置 LLM API（如通义千问、OpenAI）
3. 配置图像生成服务（ComfyUI 或 RunningHub）
4. 点击「保存配置」

**优点**：无需安装 Python、uv 或 ffmpeg，一键开箱即用

## 安装方式二：从源码安装（适合 macOS / Linux）

### 步骤 1：克隆项目
“`bash
git clone https://github.com/AIDC-AI/Pixelle-Video.git
cd Pixelle-Video
“`

### 步骤 2：启动 Web 界面
“`bash
uv run streamlit run web/app.py
“`

uv 会自动安装所有依赖项。

### 步骤 3：配置服务
1. 打开浏览器访问 http://localhost:8501
2. 配置 LLM API
3. 配置图像生成服务
4. 保存配置

## 安装方式三：手动安装依赖

如果 uv 自动安装失败，可以手动安装：

“`bash
# 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate # macOS/Linux
# 或
.venv\Scripts\activate # Windows

# 安装依赖
pip install -r requirements.txt
“`

## ComfyUI 本地部署（可选但推荐）

如需本地图像生成，需安装 ComfyUI：

### 步骤 1：克隆 ComfyUI
“`bash
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
“`

### 步骤 2：安装依赖
“`bash
pip install torch torchvision torchaudio
pip install -r requirements.txt
“`

### 步骤 3：启动 ComfyUI
“`bash
python main.py –listen 127.0.0.1 –port 8188
“`

### 步骤 4：下载模型
根据需要下载 Flux、SDXL 等模型权重

## 验证安装

运行以下命令检查环境：

“`bash
python -c “import torch; print(f’PyTorch: {torch.__version__}’)”
python -c “import whisper; print(‘Whisper installed’)”
ffmpeg -version | head -n 1
“`

## 常见问题

**Q：uv 命令找不到**
A：重启终端或重新加载环境变量

**Q：ffmpeg 安装失败**
A：使用包管理器（如 brew、apt）安装，避免手动配置

**Q：ComfyUI 连接失败**
A：确认 ComfyUI 已启动并监听 127.0.0.1:8188