mmagic

开箱即用的生成工具箱，图像视频随便造

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 1094 🐛 待处理 70 👀 关注 92

GitHub ↗

GitHub 星标 ★ 7479

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源工具箱，Apache-2.0 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类图像生成

开发团队open-mmlab

GitHubhttps://github.com/open-mmlab/mmagic

定价模式🏷️完全免费

价格说明开源工具箱，Apache-2.0 许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Jupyter Notebook

技术栈/模型aigc,computer-vision,deep-learning,diffusion,diffusion-models,generative-adversarial-network,generative-ai,image-editing,image-generation,image-processing,image-synthesis,inpainting,matting,pytorch,super-resolution,text2image,video-frame-interpolation,video-interpolation,video-super-resolution

GitHub 星标★ 7479

上线时间2019-08-23 00:00:00

代码更新2024-08-06

仓库体积32.0 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数8

项目介绍

OpenMMLab 推出的多模态生成智能创作工具箱，提供开箱即用的 AIGC 能力、易用 API 与丰富模型库，涵盖文生图、图像/视频修复与增强等任务，是搭建生成式 AI 应用的理想基座。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7479

技术标签

aigc computer-vision deep-learning diffusion diffusion-models

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 15 分钟部署方式：库/依赖 6 步

环境要求

Python 环境（建议使用 conda/venv 虚拟环境）
已安装 pip3，可执行 pip3 install
PyTorch（需按 PyTorch 官方说明自行安装）
MMCV >= 2.0.0、MMEngine（通过 MIM 安装）

安装与启动步骤

1安装 PyTorch

README 第一步要求先安装 PyTorch，具体命令请按 PyTorch 官网针对你的系统和 CUDA 版本选择。
2安装 MIM

MIM 是 OpenMMLab 的包管理工具，后续 MMCV、MMEngine、MMagic 都用它安装。
```
pip3 install openmim
```
3安装 MMCV

MMagic 依赖 MMCV 2.0.0 及以上版本，注意先装 MMCV 再装 MMEngine。
```
mim install "mmcv>=2.0.0"
```
4安装 MMEngine

MMEngine 是 OpenMMLab 2.x 的训练引擎基础库，作为 MMagic 的依赖单独安装。
```
mim install mmengine
```
5安装 MMagic

通过 MIM 安装 mmagic 本体，会自动拉取所需依赖，耗时取决于网络。
```
mim install mmagic
```
6验证安装

切换到家目录后导入 mmagic 并打印版本号，能正常输出版本即安装成功。
```
cd ~
python -c "import mmagic; print(mmagic.__version__)"
```

如何确认成功

执行 python -c "import mmagic; print(mmagic.__version__)"，终端打印出 MMagic 版本号且不报错，即为安装成功。

常见问题

Q：需要先单独安装 PyTorch 吗？

A：需要。README 明确将安装 PyTorch 列为第一步，请先按 PyTorch 官网说明安装，再执行后续 mim 安装命令。

Q：为什么用 mim 而不是 pip 安装 MMCV？

A：README 推荐使用 MIM 安装 MMCV、MMEngine 与 MMagic，MIM 会自动匹配与 PyTorch 版本兼容的 MMCV 预编译包，避免编译报错。

Q：安装顺序可以打乱吗？

A：建议按 README 顺序：先 PyTorch，再 MMCV，然后 MMEngine，最后 MMagic，避免依赖不匹配导致的导入失败。

Q：验证时提示 No module named 'mmagic' 怎么办？

A：说明 mmagic 未安装成功或装到了其他 Python 环境，请确认当前终端激活的环境与执行 mim install mmagic 时一致，然后重试安装。

注意事项

README 未给出具体 Python / CUDA 版本要求，请以官方安装文档 https://mmagic.readthedocs.io/en/latest/get_started/install.html 为准。
README 原文写的是 mim install mmcv>=2.0.0，直接复制到 bash 会被当成重定向，本教程加了引号以保证可执行。
本教程仅覆盖 README 中给出的安装与验证步骤，训练、推理与模型下载使用方法请查阅官方文档与 Model Zoo。