PowerPaint

环境要求

• 已安装 Python 与 pip，可执行 pip install
• 或已安装 Conda，可执行 conda env create / conda activate
• 已安装 Git 并可访问 GitHub
• 建议具备可用的 GPU 环境（PowerPaint 基于 Stable Diffusion）
• 磁盘空间需容纳依赖与大体积模型权重文件

安装与启动步骤

1. 1克隆项目仓库

   把 PowerPaint 源码下载到本地，后续的 requirements 文件都在仓库内。建议在空目录中执行，避免路径混乱。

   git clone https://github.com/open-mmlab/PowerPaint.git

   复制

2. 2pip 方式装依赖

   进入仓库根目录后按 README 用 requirements 文件安装依赖。这是两种安装方式之一，与 conda 方式二选一。

   cd PowerPaint
   pip install -r requirements/requirements.txt

   复制

3. 3conda 方式建环境

   README 提供的另一种做法：从零构建 conda 环境 ppt。如果你已经用 pip 装过依赖，就不需要再执行这一步。

   cd PowerPaint
   conda env create -f requirements/ppt.yaml

   复制

4. 4激活 conda 环境

   使用 conda 方式安装后需激活 ppt 环境再运行代码。此步仅适用于上一步 conda 建环境的情况。

   conda activate ppt

   复制

5. 5配置 Git LFS

   README 要求安装 git-lfs 并初始化，用于拉取仓库中的大体积文件（如模型权重）。需在有 conda 的环境下执行。

   conda install git-lfs
   git lfs install

   复制

如何确认成功

依赖安装过程无报错，命令 conda activate ppt 能正常进入 ppt 环境，即表示基础环境准备完成。

常见问题

注意事项

• 必须先用 git clone 获取仓库，requirements/ppt.yaml 与 requirements/requirements.txt 都在仓库目录内。
• pip 与 conda 两种安装方式择一即可，混用可能造成依赖版本冲突。
• conda activate ppt 仅在使用 ppt.yaml 建环境时才需要执行。
• 模型权重不在本段 README 中给出下载命令，请按官方 HuggingFace / OpenXLab 页面指引获取。