源码安装部署

适用于 macOS / Linux 用户，或需要深度定制的用户。

前置环境

安装 uv（Python 包管理器）

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

验证安装: uv --version

安装 ffmpeg

# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt update && sudo apt install ffmpeg

# Windows: 下载 https://ffmpeg.org/download.html，解压后加入 PATH

验证安装: ffmpeg -version

克隆并启动

# 克隆项目
git clone https://github.com/AIDC-AI/Pixelle-Video.git
cd Pixelle-Video

# 启动 Web 界面（自动安装依赖）
uv run streamlit run web/app.py

浏览器会自动打开 http://localhost:8501

配置

首次使用需要配置 LLM API Key 和图像生成服务，参见 系统配置指南。