更新Windows一键整合包相关的文档说明
This commit is contained in:
30
README.md
30
README.md
@@ -115,18 +115,36 @@ Pixelle-Video 采用模块化设计,整个视频生成流程清晰简洁:
|
|||||||
|
|
||||||
## 🚀 快速开始
|
## 🚀 快速开始
|
||||||
|
|
||||||
### 前置环境依赖
|
### 🪟 Windows 一键整合包(推荐 Windows 用户使用)
|
||||||
|
|
||||||
|
**无需安装 Python、uv 或 ffmpeg,一键开箱即用!**
|
||||||
|
|
||||||
|
👉 **[下载 Windows 一键整合包](https://github.com/AIDC-AI/Pixelle-Video/releases/latest)**
|
||||||
|
|
||||||
|
1. 下载最新的 Windows 一键整合包并解压
|
||||||
|
2. 双击运行 `start.bat` 启动 Web 界面
|
||||||
|
3. 浏览器会自动打开 http://localhost:8501
|
||||||
|
4. 在「⚙️ 系统配置」中配置 LLM API 和图像生成服务
|
||||||
|
5. 开始生成视频!
|
||||||
|
|
||||||
|
> 💡 **提示**: 整合包已包含所有依赖,无需手动安装任何环境。首次使用只需配置 API 密钥即可。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 从源码安装(适合 macOS / Linux 用户或需要自定义的用户)
|
||||||
|
|
||||||
|
#### 前置环境依赖
|
||||||
|
|
||||||
在开始之前,需要先安装 Python 包管理器 `uv` 和视频处理工具 `ffmpeg`:
|
在开始之前,需要先安装 Python 包管理器 `uv` 和视频处理工具 `ffmpeg`:
|
||||||
|
|
||||||
#### 安装 uv
|
##### 安装 uv
|
||||||
|
|
||||||
请访问 uv 官方文档查看适合你系统的安装方法:
|
请访问 uv 官方文档查看适合你系统的安装方法:
|
||||||
👉 **[uv 安装指南](https://docs.astral.sh/uv/getting-started/installation/)**
|
👉 **[uv 安装指南](https://docs.astral.sh/uv/getting-started/installation/)**
|
||||||
|
|
||||||
安装完成后,在终端中运行 `uv --version` 验证安装成功。
|
安装完成后,在终端中运行 `uv --version` 验证安装成功。
|
||||||
|
|
||||||
#### 安装 ffmpeg
|
##### 安装 ffmpeg
|
||||||
|
|
||||||
**macOS**
|
**macOS**
|
||||||
```bash
|
```bash
|
||||||
@@ -147,14 +165,14 @@ sudo apt install ffmpeg
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 第一步:下载项目
|
#### 第一步:下载项目
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/AIDC-AI/Pixelle-Video.git
|
git clone https://github.com/AIDC-AI/Pixelle-Video.git
|
||||||
cd Pixelle-Video
|
cd Pixelle-Video
|
||||||
```
|
```
|
||||||
|
|
||||||
### 第二步:启动 Web 界面
|
#### 第二步:启动 Web 界面
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 使用 uv 运行(推荐,会自动安装依赖)
|
# 使用 uv 运行(推荐,会自动安装依赖)
|
||||||
@@ -163,7 +181,7 @@ uv run streamlit run web/app.py
|
|||||||
|
|
||||||
浏览器会自动打开 http://localhost:8501
|
浏览器会自动打开 http://localhost:8501
|
||||||
|
|
||||||
### 第三步:在 Web 界面配置
|
#### 第三步:在 Web 界面配置
|
||||||
|
|
||||||
首次使用时,展开「⚙️ 系统配置」面板,填写:
|
首次使用时,展开「⚙️ 系统配置」面板,填写:
|
||||||
- **LLM 配置**: 选择 AI 模型(如通义千问、GPT 等)并填入 API Key
|
- **LLM 配置**: 选择 AI 模型(如通义千问、GPT 等)并填入 API Key
|
||||||
|
|||||||
30
README_EN.md
30
README_EN.md
@@ -115,18 +115,36 @@ Here are actual cases generated using Pixelle-Video, showcasing video effects wi
|
|||||||
|
|
||||||
## 🚀 Quick Start
|
## 🚀 Quick Start
|
||||||
|
|
||||||
### Prerequisites
|
### 🪟 Windows All-in-One Package (Recommended for Windows Users)
|
||||||
|
|
||||||
|
**No need to install Python, uv, or ffmpeg - ready to use out of the box!**
|
||||||
|
|
||||||
|
👉 **[Download Windows All-in-One Package](https://github.com/AIDC-AI/Pixelle-Video/releases/latest)**
|
||||||
|
|
||||||
|
1. Download the latest Windows All-in-One Package and extract it
|
||||||
|
2. Double-click `start.bat` to launch the Web interface
|
||||||
|
3. Browser will automatically open http://localhost:8501
|
||||||
|
4. Configure LLM API and image generation service in "⚙️ System Configuration"
|
||||||
|
5. Start generating videos!
|
||||||
|
|
||||||
|
> 💡 **Tip**: The package includes all dependencies, no need to manually install any environment. On first use, you only need to configure API keys.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Install from Source (For macOS / Linux Users or Users Who Need Customization)
|
||||||
|
|
||||||
|
#### Prerequisites
|
||||||
|
|
||||||
Before starting, you need to install Python package manager `uv` and video processing tool `ffmpeg`:
|
Before starting, you need to install Python package manager `uv` and video processing tool `ffmpeg`:
|
||||||
|
|
||||||
#### Install uv
|
##### Install uv
|
||||||
|
|
||||||
Please visit the uv official documentation to see the installation method for your system:
|
Please visit the uv official documentation to see the installation method for your system:
|
||||||
👉 **[uv Installation Guide](https://docs.astral.sh/uv/getting-started/installation/)**
|
👉 **[uv Installation Guide](https://docs.astral.sh/uv/getting-started/installation/)**
|
||||||
|
|
||||||
After installation, run `uv --version` in the terminal to verify successful installation.
|
After installation, run `uv --version` in the terminal to verify successful installation.
|
||||||
|
|
||||||
#### Install ffmpeg
|
##### Install ffmpeg
|
||||||
|
|
||||||
**macOS**
|
**macOS**
|
||||||
```bash
|
```bash
|
||||||
@@ -147,14 +165,14 @@ After installation, run `ffmpeg -version` in the terminal to verify successful i
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Step 1: Clone Project
|
#### Step 1: Clone Project
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/AIDC-AI/Pixelle-Video.git
|
git clone https://github.com/AIDC-AI/Pixelle-Video.git
|
||||||
cd Pixelle-Video
|
cd Pixelle-Video
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 2: Launch Web Interface
|
#### Step 2: Launch Web Interface
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Run with uv (recommended, will automatically install dependencies)
|
# Run with uv (recommended, will automatically install dependencies)
|
||||||
@@ -163,7 +181,7 @@ uv run streamlit run web/app.py
|
|||||||
|
|
||||||
Browser will automatically open http://localhost:8501
|
Browser will automatically open http://localhost:8501
|
||||||
|
|
||||||
### Step 3: Configure in Web Interface
|
#### Step 3: Configure in Web Interface
|
||||||
|
|
||||||
On first use, expand the "⚙️ System Configuration" panel and fill in:
|
On first use, expand the "⚙️ System Configuration" panel and fill in:
|
||||||
- **LLM Configuration**: Select AI model (such as Qwen, GPT, etc.) and enter API Key
|
- **LLM Configuration**: Select AI model (such as Qwen, GPT, etc.) and enter API Key
|
||||||
|
|||||||
@@ -19,7 +19,26 @@ This page will guide you through installing Pixelle-Video.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Installation Steps
|
## 🪟 Windows All-in-One Package (Recommended for Windows Users)
|
||||||
|
|
||||||
|
**No need to install Python, uv, or ffmpeg - ready to use out of the box!**
|
||||||
|
|
||||||
|
### Download and Install
|
||||||
|
|
||||||
|
1. Visit [GitHub Releases](https://github.com/AIDC-AI/Pixelle-Video/releases/latest) to download the latest version
|
||||||
|
2. Download the latest Windows All-in-One Package and extract it to any directory
|
||||||
|
3. Double-click `start.bat` to launch the Web interface
|
||||||
|
4. Your browser will automatically open `http://localhost:8501`
|
||||||
|
|
||||||
|
!!! success "Installation Complete!"
|
||||||
|
The package includes all dependencies, no need to manually install any environment. On first use, you only need to configure API keys in "⚙️ System Configuration" to get started.
|
||||||
|
|
||||||
|
!!! tip "Next Steps"
|
||||||
|
After installation, check out the [Configuration Guide](configuration.md) to set up LLM and image generation services, then see [Quick Start](quick-start.md) to create your first video.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Install from Source (For macOS / Linux Users or Users Who Need Customization)
|
||||||
|
|
||||||
### Step 1: Clone the Repository
|
### Step 1: Clone the Repository
|
||||||
|
|
||||||
|
|||||||
@@ -6,6 +6,14 @@ Already installed and configured? Let's create your first video!
|
|||||||
|
|
||||||
## Start the Web Interface
|
## Start the Web Interface
|
||||||
|
|
||||||
|
### Windows All-in-One Package Users
|
||||||
|
|
||||||
|
If you're using the Windows All-in-One Package, simply:
|
||||||
|
1. Double-click `start.bat`
|
||||||
|
2. Your browser will automatically open `http://localhost:8501`
|
||||||
|
|
||||||
|
### Install from Source Users
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Using uv
|
# Using uv
|
||||||
uv run streamlit run web/app.py
|
uv run streamlit run web/app.py
|
||||||
|
|||||||
@@ -52,6 +52,8 @@ Simply input a **topic**, and Pixelle-Video will automatically:
|
|||||||
Ready to get started? Just three steps:
|
Ready to get started? Just three steps:
|
||||||
|
|
||||||
1. **[Install Pixelle-Video](getting-started/installation.md)** - Download and install the project
|
1. **[Install Pixelle-Video](getting-started/installation.md)** - Download and install the project
|
||||||
|
- 🪟 **Windows Users (Recommended)**: Use the [All-in-One Package](https://github.com/AIDC-AI/Pixelle-Video/releases/latest), no Python installation required
|
||||||
|
- 💻 **macOS/Linux Users**: Install from source, see [Installation Guide](getting-started/installation.md)
|
||||||
2. **[Configure Services](getting-started/configuration.md)** - Set up LLM and image generation services
|
2. **[Configure Services](getting-started/configuration.md)** - Set up LLM and image generation services
|
||||||
3. **[Create Your First Video](getting-started/quick-start.md)** - Start creating your first video
|
3. **[Create Your First Video](getting-started/quick-start.md)** - Start creating your first video
|
||||||
|
|
||||||
|
|||||||
@@ -19,7 +19,26 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 安装步骤
|
## 🪟 Windows 一键整合包(推荐 Windows 用户使用)
|
||||||
|
|
||||||
|
**无需安装 Python、uv 或 ffmpeg,一键开箱即用!**
|
||||||
|
|
||||||
|
### 下载和安装
|
||||||
|
|
||||||
|
1. 访问 [GitHub Releases](https://github.com/AIDC-AI/Pixelle-Video/releases/latest) 下载最新版本
|
||||||
|
2. 下载最新的 Windows 一键整合包并解压到任意目录
|
||||||
|
3. 双击运行 `start.bat` 启动 Web 界面
|
||||||
|
4. 浏览器会自动打开 `http://localhost:8501`
|
||||||
|
|
||||||
|
!!! success "安装完成!"
|
||||||
|
整合包已包含所有依赖,无需手动安装任何环境。首次使用只需在「⚙️ 系统配置」中配置 API 密钥即可开始使用。
|
||||||
|
|
||||||
|
!!! tip "下一步"
|
||||||
|
安装完成后,请查看 [配置说明](configuration.md) 来设置 LLM 和图像生成服务,然后查看 [快速开始](quick-start.md) 生成第一个视频。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 从源码安装(适合 macOS / Linux 用户或需要自定义的用户)
|
||||||
|
|
||||||
### 第一步:克隆项目
|
### 第一步:克隆项目
|
||||||
|
|
||||||
|
|||||||
@@ -6,6 +6,14 @@
|
|||||||
|
|
||||||
## 启动 Web 界面
|
## 启动 Web 界面
|
||||||
|
|
||||||
|
### Windows 一键整合包用户
|
||||||
|
|
||||||
|
如果你使用的是 Windows 一键整合包,只需:
|
||||||
|
1. 双击运行 `start.bat`
|
||||||
|
2. 浏览器会自动打开 `http://localhost:8501`
|
||||||
|
|
||||||
|
### 从源码安装用户
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 使用 uv 运行
|
# 使用 uv 运行
|
||||||
uv run streamlit run web/app.py
|
uv run streamlit run web/app.py
|
||||||
|
|||||||
@@ -52,6 +52,8 @@
|
|||||||
想马上体验?只需三步:
|
想马上体验?只需三步:
|
||||||
|
|
||||||
1. **[安装 Pixelle-Video](getting-started/installation.md)** - 下载并安装项目
|
1. **[安装 Pixelle-Video](getting-started/installation.md)** - 下载并安装项目
|
||||||
|
- 🪟 **Windows 用户推荐**: 使用 [一键整合包](https://github.com/AIDC-AI/Pixelle-Video/releases/latest),无需安装 Python 环境
|
||||||
|
- 💻 **macOS/Linux 用户**: 从源码安装,详见 [安装指南](getting-started/installation.md)
|
||||||
2. **[配置服务](getting-started/configuration.md)** - 配置 LLM 和图像生成服务
|
2. **[配置服务](getting-started/configuration.md)** - 配置 LLM 和图像生成服务
|
||||||
3. **[生成第一个视频](getting-started/quick-start.md)** - 开始创作你的第一个视频
|
3. **[生成第一个视频](getting-started/quick-start.md)** - 开始创作你的第一个视频
|
||||||
|
|
||||||
|
|||||||
@@ -39,7 +39,7 @@ The build process creates:
|
|||||||
|
|
||||||
```
|
```
|
||||||
dist/windows/
|
dist/windows/
|
||||||
├── Pixelle-Video-v0.1.0-win64/ # Build directory
|
├── Pixelle-Video-v*-win64/ # Build directory (version number varies)
|
||||||
│ ├── python/ # Python embedded
|
│ ├── python/ # Python embedded
|
||||||
│ ├── tools/ # FFmpeg, etc.
|
│ ├── tools/ # FFmpeg, etc.
|
||||||
│ ├── Pixelle-Video/ # Project files
|
│ ├── Pixelle-Video/ # Project files
|
||||||
@@ -49,8 +49,8 @@ dist/windows/
|
|||||||
│ ├── start_api.bat # API launcher
|
│ ├── start_api.bat # API launcher
|
||||||
│ ├── start_web.bat # Web launcher
|
│ ├── start_web.bat # Web launcher
|
||||||
│ └── README.txt # User guide
|
│ └── README.txt # User guide
|
||||||
├── Pixelle-Video-v0.1.0-win64.zip # ZIP package
|
├── Pixelle-Video-v*-win64.zip # ZIP package (version number varies)
|
||||||
└── Pixelle-Video-v0.1.0-win64.zip.sha256 # Checksum
|
└── Pixelle-Video-v*-win64.zip.sha256 # Checksum (version number varies)
|
||||||
```
|
```
|
||||||
|
|
||||||
## Build Process
|
## Build Process
|
||||||
@@ -205,7 +205,7 @@ Users verify download:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Windows PowerShell
|
# Windows PowerShell
|
||||||
Get-FileHash Pixelle-Video-v0.1.0-win64.zip -Algorithm SHA256
|
Get-FileHash Pixelle-Video-v*-win64.zip -Algorithm SHA256
|
||||||
```
|
```
|
||||||
|
|
||||||
Compare with `.sha256` file.
|
Compare with `.sha256` file.
|
||||||
|
|||||||
Reference in New Issue
Block a user