2.2 KiB
2.2 KiB
安装
本页面将指导你完成 Pixelle-Video 的安装。
系统要求
必需条件
- Python: 3.10 或更高版本
- 操作系统: Windows、macOS 或 Linux
- 包管理器: uv（推荐）或 pip
可选条件
- GPU: 如需本地运行 ComfyUI，建议配备 NVIDIA 显卡（6GB+ 显存）
- 网络: 稳定的网络连接（用于调用 LLM API 和图像生成服务）
安装步骤
第一步：克隆项目
git clone https://github.com/PixelleLab/Pixelle-Video.git
cd Pixelle-Video
第二步：安装依赖
!!! tip "推荐使用 uv"
本项目使用 uv 作为包管理器，它比传统的 pip 更快、更可靠。
使用 uv（推荐）
# 如果还没有安装 uv，先安装它
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装项目依赖（uv 会自动创建虚拟环境）
uv sync
使用 pip
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
# 安装依赖
pip install -e .
验证安装
运行以下命令验证安装是否成功：
# 使用 uv
uv run streamlit run web/app.py
# 或使用 pip（需先激活虚拟环境）
streamlit run web/app.py
浏览器应该会自动打开 http://localhost:8501，显示 Pixelle-Video 的 Web 界面。
!!! success "安装成功！" 如果能看到 Web 界面，说明安装成功了！接下来请查看 配置说明 来设置服务。
可选：安装 ComfyUI（本地部署）
如果希望本地运行图像生成服务，需要安装 ComfyUI：
快速安装
# 克隆 ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
# 安装依赖
pip install -r requirements.txt
启动 ComfyUI
python main.py
ComfyUI 默认运行在 http://127.0.0.1:8188
!!! info "ComfyUI 模型" ComfyUI 需要下载对应的模型文件才能工作。请参考 ComfyUI 官方文档 了解如何下载和配置模型。