AIDC-AI/Pixelle-Video - 快速上手

❤️❤️❤️❤️❤️❤️ 我们已经正式推出微信小程序，在微信中搜索 TrendForge Pro 即可使用小程序，如果使用 Telegram 请搜索 trendforge_tg ❤️❤️❤️❤️❤️❤️

项目介绍快速开始学习路径项目截图 3 贡献者 7 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品依赖分析上榜历史

Pixelle-Video 5分钟快速开始

输入一个主题，AI自动完成文案、配图、语音、背景音乐和视频合成，零门槛生成短视频。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Python 3.10+ 必需

所需工具

Python包管理器

必需

ffmpeg

视频处理工具

必需

操作步骤

安装依赖

安装uv和ffmpeg（macOS/Linux使用包管理器，Windows需手动下载）

安装uv（macOS/Linux）

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

macOS安装ffmpeg

brew install ffmpeg

Ubuntu/Debian安装ffmpeg

sudo apt install ffmpeg

预期结果：：uv --version 和 ffmpeg -version 显示版本号

Windows用户下载整合包可跳过此步

下载项目

克隆Pixelle-Video仓库

克隆项目

git clone https://github.com/AIDC-AI/Pixelle-Video.git

进入项目目录

cd Pixelle-Video

预期结果：：目录下出现Pixelle-Video文件夹

也可直接下载ZIP包

启动Web界面

使用uv运行Streamlit应用

启动Web界面

uv run streamlit run app.py

预期结果：：终端显示Local URL: http://localhost:8501

首次运行会自动安装依赖，请保持网络畅通

配置API密钥

在浏览器打开http://localhost:8501，展开左侧'系统配置'，填写LLM API Key（如通义千问）和图像生成服务（如ComfyUI地址或RunningHub Key）

预期结果：：点击'保存配置'后提示成功

若使用本地ComfyUI，需先启动ComfyUI服务

生成视频

在左侧输入主题（如'为什么要养成阅读习惯'），点击右侧'生成视频'按钮

预期结果：：页面显示实时进度，完成后自动播放视频

首次生成约需2-5分钟，取决于AI服务响应速度

验证成功

视频生成完成后，可在页面预览或到output/文件夹查看生成的MP4文件

页面显示视频预览

output/目录下存在视频文件

快速提示

安装

Windows用户推荐下载一键整合包，无需安装Python和ffmpeg

配置

LLM推荐使用通义千问（免费额度高），图像推荐本地ComfyUI

使用

可在'视觉设置'中更换模板和提示词前缀来调整风格

常见问题

启动时提示'uv not found'

确保uv已正确安装，或使用 pip install uv 安装

浏览器无法打开localhost:8501

检查终端是否报错，尝试关闭防火墙或更换端口

生成视频时卡在'生成文案'

检查LLM API Key是否正确，网络是否可访问API地址

下一步

探索更多功能

尝试数字人口播、图生视频、动作迁移等扩展模块

自定义工作流

在workflows/目录添加自己的ComfyUI工作流

加入社区

扫描README中的微信群或Discord二维码获取帮助