新增示例库逻辑

This commit is contained in:
puke
2025-11-03 17:44:33 +08:00
parent 6f114b61c7
commit ec395196cd
43 changed files with 2567 additions and 406 deletions

View File

@@ -0,0 +1,115 @@
# 安装
本页面将指导你完成 Pixelle-Video 的安装。
---
## 系统要求
### 必需条件
- **Python**: 3.10 或更高版本
- **操作系统**: Windows、macOS 或 Linux
- **包管理器**: uv推荐或 pip
### 可选条件
- **GPU**: 如需本地运行 ComfyUI建议配备 NVIDIA 显卡6GB+ 显存)
- **网络**: 稳定的网络连接(用于调用 LLM API 和图像生成服务)
---
## 安装步骤
### 第一步:克隆项目
```bash
git clone https://github.com/PixelleLab/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) - 生成第一个视频