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