开源项目解析
Real-ESRGAN
通用图像 / 视频超分修复,支持 2× / 3× / 4×,含动漫专用与轻量模型。
只做放大这一件事作者本人有讲解视频
读懂层
2 张 · 架构图 / 流程图
DeepWiki 架构页 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
它管哪几个决定
分镜先出图,再图生视频
8/10 家有官方说法自持能力
权重在不在本地可下载到本地
种子能不能填不涉及
换掉它要动几处一处
末端环节,接上或摘掉不影响前面
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1权重下到 weights/`wget ... -P weights`;四个模型按素材选,不是越大越好
- 2python inference_realesrgan.py -n <模型> -i inputs默认 `RealESRGAN_x4plus`;动漫用 `RealESRGAN_x4plus_anime_6B`(模型小得多)
改哪个文件能改什么
-t 分块大小**爆显存就调大它**(0 = 不分块)。分块是省显存的唯一手段-s 放大倍数最终倍数,默认 4。与模型自身倍数是两回事--face_enhance接 GFPGAN 修人脸。风景素材开了纯属浪费时间--fp32默认 fp16;出现数值问题(花屏、NaN)时切它坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
分块处理官方明示 NCNN 版可能出现拼接痕 —— 大图分块各自处理再拼回来,接缝处不一致
装不上issue #275「ModuleNotFoundError: No module named 'realesrgan.version'」开着 —— 这是最常见的安装报错,先查它再查别的
显卡没被用上issue #670「GPU not utilized on Linux」开着 —— 跑得慢先确认 CUDA 真的在用,别急着调参数
放大倍数倍数越高伪细节越明显;#233 想做 x8 至今没有官方支持。超分补不出原本不存在的信息
训练侧#403 微调时 CUDA OOM 开着 —— 推理门槛低,微调门槛完全是另一回事
教程
官方文档、作者本人的视频,以及 ComfyUI 官方给的原生工作流示例。每条都验过还打得开。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
English | 简体中文
👀Demos | 🚩Updates | ⚡Usage | 🏰Model Zoo | 🔧Install | 💻Train | ❓FAQ | 🎨Contribution
🔥 AnimeVideo-v3 model (动漫视频小模型). Please see [*anime video models*] and [*comparisons*]
🔥 RealESRGAN_x4plus_anime_6B for anime images (动漫插图模型). Please see [*anime_model*]
1. :boom: Update online Replicate demo:
1. Online Colab demo for Real-ESRGAN: | Online Colab demo for for Real-ESRGAN (anime videos):
1. Portable Windows / Linux / MacOS executable files for Intel/AMD/Nvidia GPU. You can find more information here. The ncnn implementation is in Real-ESRGAN-ncnn-vulkan
Real-ESRGAN aims at developing Practical Algorithms for General Image/Video Restoration.
We extend the powerful ESRGAN to a practical restoration application (namely, Real-ESRGAN), which is trained with pure synthetic data.
🌌 Thanks for your valuable feedbacks/suggestions. All the feedbacks are updated in feedback.md.
If Real-ESRGAN is helpful, please help to ⭐ this repo or recommend it to your friends 😊
Other recommended projects:
▶️ GFPGAN: A practical algorithm for real-world face restoration
▶️ BasicSR: An open-source image and video restoration toolbox
▶️ facexlib: A collection that provides useful face-relation functions.
▶️ HandyView: A PyQt5-based image viewer that is handy for view and comparison
▶️ HandyFigure: Open source of paper figures
📖 Real-ESRGAN: Training Real-World Blind Super-Resolution with Pure Synthetic Data
> [Paper]   [YouTube Video]   [B站讲解]   [Poster]   [PPT slides]
> Xintao Wang, Liangbin Xie, Chao Dong, Ying Shan
> Tencent ARC Lab; Shenzhen Institutes of Advanced Technology, Chinese Academy of Sciences
🚩 Updates
- ✅ Add the realesr-general-x4v3 model - a tiny small model for general scenes. It also supports the -dn option to balance the noise (avoiding over-smooth results). -dn is short for denoising strength.
- ✅ Update the RealESRGAN AnimeVideo-v3 model. Please see anime video models and comparisons for more details.
- ✅ Add small models for anime videos. More details are in anime video models.
- ✅ Add the ncnn implementation Real-ESRGAN-ncnn-vulkan.
- ✅ Add *RealESRGAN_x4plus_anime_6B.pth*, which is optimized for anime images with much smaller model size. More details and comparisons with waifu2x are in anime_model.md
- ✅ Support finetuning on your own data or paired data (*i.e.*, finetuning ESRGAN). See here
- ✅ Integrate GFPGAN to support face enhancement.
- ✅ Integrated to Huggingface Spaces with Gradio. See Gradio Web Demo. Thanks @AK391
- ✅ Support arbitrary scale with --outscale (It actually further resizes outputs with LANCZOS4). Add *RealESRGAN_x2plus.pth* model.
- ✅ The inference code supports: 1) tile options; 2) images with alpha channel; 3) gray images; 4) 16-bit images.
- ✅ The training codes have been released. A detailed guide can be found in Training.md.
👀 Demos Videos
Bilibili
- 大闹天宫片段
- Anime dance cut 动漫魔性舞蹈
- 海贼王片段
YouTube
🔧 Dependencies and Installation
- Python >= 3.7 (Recommend to use Anaconda or Miniconda)
- PyTorch >= 1.7
Installation
1. Clone repo
bash
git clone https://github.com/xinntao/Real-ESRGAN.git
cd Real-ESRGAN
1. Install dependent packages
……(后略,见原文)判断
优势
- ★36.5k,超分领域事实标准
- 有动漫专用与轻量模型,按素材选
- BSD-3,商用最宽松的一档
局限
- 停更 24 个月(最后提交 2024-08-06)—— 超分这一格变化慢,但它确实已经不再更新
- 分块处理可能出现拼接痕(官方在 NCNN 版明示)
- 放大倍数越高伪细节越明显
不适用
源素材本身糊得厉害时 —— 超分补不出不存在的信息。
同管这些决定的其它项目
ComfyUI节点式工作流底座。图像 / 视频 / 音频 / 3D / 文本共用一个底座。…Wan2.2文生 / 图生 / 语音驱动 / 角色动画替换,480P–720P。五个变体。…HunyuanVideo腾讯的开源视频生成模型,文生视频与图生视频。720×1280、129 帧。…FramePack把 13B 视频模型压进 6GB 显存的桌面程序。图生视频,一分钟长度、30 帧。…LTX-VideoLightricks 的视频生成模型,主打快。文生 / 图生 / 视频续写,默认 1…MiniMax H3全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz…Practical-RIFE视频插帧:在两帧之间算出中间帧,把 24 帧的片子补成 48、60 帧。作者是 RI…CodeFormer人脸修复:把糊掉、压坏、老照片里的脸修回来。图片与视频都能做。…Ollama一条命令在本机跑开源大模型。写脚本、翻译这两段靠它才不出本机。…DiffSynth-Studio魔搭扩散模型工程框架,覆盖图像、视频、音乐推理与训练;近期加入 FLUX.3、MOS…MoneyPrinterTurbo给个主题或关键词,一键出高清短视频,含字幕与配音。…火宝短剧基于 AI 的一站式短剧生成平台,从剧本到成片全自动化。…ToonflowAI 创作平台:无限画布、AI Agent、可视化工作流,支持图像、视频、分镜和短剧…infinite-canvas面向 AI 创作的无限画布工作台:生图、参考图编辑、视频生成、Agent 助手、画布…open-ai-canvas面向 AI 影视创作的无限画布:多模态生成、分镜编排、素材管理、Agent 工作流。…VOZEB PRO把统一创作 Agent、画布、短剧生产线、素材库和商业运营后台放进同一套 Next.…OpenMontage让 Agent 编排视频生产:通过声明式流水线组织素材、生成、字幕、音频与合成。…video-shotcraft为 Claude Code / Codex 提供产品宣传片镜头配方,以网页截图与文案…Generative Media Skills给 Agent(Claude Code / Cursor / Gemini CLI)…ComfyUI-ManagerComfyUI 的节点管理器:装节点、装模型、修依赖、查注册表。ComfyUI 生态…ComfyUI-WanVideoWrapper把 Wan 系列模型接进 ComfyUI 的节点包。社区里跑 Wan 的事实标准封装…ComfyUI 官方工作流模板ComfyUI 内置的那批官方工作流模板与子图蓝图的真身仓库。…waoowaoo把一部小说灌进去,自动拆角色、拆场景、出分镜,再合成整集短剧。中英双界面。…JellyfishAI 短剧的端到端工作台:从剧本进,到分镜、角色一致性管理、出片、导出。…魔因漫创桌面端 AI 影视工具(Electron):剧本 → 角色 → 场景 → 导演 → …BigBanana AI Director一站式 AI 短剧 / 漫剧工作台,四阶段:剧本 → 视觉资产 → 分镜制作 → 导…ClipForge带货短视频专用的一站式工具:上传商品图,自动提炼卖点、写种草脚本、配音配字幕加背景乐…短视频工厂跨平台桌面应用:给提示词文本加分镜素材,自动剪出产品营销或泛内容短视频。集成文案生成…AI YouTube Shorts Generator把一条长视频切成一批排好序的竖屏短片:用语言模型找高光片段、用 Whisper 转写…Open AI UGC生成 UGC 风格的口播广告:用多个视频模型出真人感的 AI 演员念你的脚本。定位是…ViGenAiR把一条已有的视频广告用生成式 AI 重新剪成适配不同版位与时长的多条。…Seedance 2.0 Prompt Skills给 Agent 装的 Seedance 2.0 提示词技能:讲输入约束、@ 引用语法…Drama Skills面向编剧与漫剧工作室的短剧创作流水线:十个技能把一个点子或一部长篇材料,一路做成分集…Seedance2 Storyboard Generator开源剧情剧本技能:把故事拆成分镜,并整合成 Seedance 2.0 认的结构化提示…AI Shortfilm Prompts一个 Claude Code 技能:把任意一个想法变成电影语言的、模型直接能用的视频…Awesome Seedance 2 Prompts整理好的 Seedance 2.0 视频提示词库,README 自述逾六千条,覆盖电…歸藏的提示词库中文 AI 圈里流传最广的个人提示词仓库之一,存放作者为各家模型撰写的提示词。…AI Visual Prompt Cookbook171 套结构化提示词风格、342 张预览;JSON 模板支持 v2.1 / v2.…PromptLensAI 视频提示词分析工具:丢进一条别人的视频,反推出它的提示词与创作脚本,并做画面分…Prompt Engineering Guide提示词工程的系统性指南:教程、论文、课程笔记与可运行的示例。不针对视频,讲的是提示词…蓝书 AI 视频工具包AI 视频提示词、技能与方法论工具包。2026-10-10 README 自述:60…
github README + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。