diff --git a/README.md b/README.md index 909dff0cc5323e1209ce9dcc745c6ccee426f946..82882de9cff5055cd8011ddd2f9b919b414edc3a 100644 --- a/README.md +++ b/README.md @@ -1,55 +1,23 @@ -
- -
简体中文 | [English](./README_en.md) # PaddleGAN -PaddleGAN 是一个基于飞桨的生成对抗网络开发工具包. - -### 图片变换 -
- -
- -### 妆容迁移 -
- -
- -### 老视频修复 -
- -
+飞桨生成对抗网络开发套件--PaddleGAN，为开发者提供经典及前沿的生成对抗网络高性能实现，并支撑开发者快速构建、训练及部署生成对抗网络，以供学术、娱乐及产业应用。 -### 超分辨率 -
- -
+GAN--生成对抗网络，被“卷积网络之父”**Yann LeCun（杨立昆）**誉为**「过去十年计算机科学领域最有趣的想法之一」**，是近年来火遍全网，AI研究者最为关注的深度学习技术方向之一。 -### 动作驱动
- +
-特性: - -- 高度的灵活性: - - 模块化设计，解耦各个网络组件，开发者轻松搭建、试用各种检测模型及优化策略，快速得到高性能、定制化的算法。 - -- 丰富的应用: - - PaddleGAN 提供了非常多的应用，比如说图像生成，图像修复，图像上色，视频补帧，人脸妆容迁移等. - -## 安装 - -请参考[安装文档](./docs/zh_CN/install.md)来进行PaddlePaddle和ppgan的安装 +[![License](https://img.shields.io/badge/license-Apache%202-red.svg)](LICENSE)![python version](https://img.shields.io/badge/python-3.6+-orange.svg) ## 快速开始 -通过ppgan.app接口使用预训练模型: +* 请确保您按照[安装文档](./docs/zh_CN/install.md)的说明正确安装了PaddlePaddle和PaddleGAN + +* 通过ppgan.app接口使用预训练模型: ```python from ppgan.apps import RealSRPredictor @@ -57,28 +25,64 @@ PaddleGAN 是一个基于飞桨的生成对抗网络开发工具包. sr.run("docs/imgs/monarch.png") ``` -更多训练、评估教程参考: +* 更多训练、评估教程: + * [数据准备](./docs/zh_CN/data_prepare.md) + * [训练/评估/推理教程](./docs/zh_CN/get_started.md) -- [数据准备](./docs/zh_CN/data_prepare.md) -- [训练/评估/推理教程](./docs/zh_CN/get_started.md) - -## 模型教程 +## 经典模型实现 * [Pixel2Pixel](./docs/zh_CN/tutorials/pix2pix_cyclegan.md) * [CycleGAN](./docs/zh_CN/tutorials/pix2pix_cyclegan.md) * [PSGAN](./docs/zh_CN/tutorials/psgan.md) * [First Order Motion Model](./docs/zh_CN/tutorials/motion_driving.md) + +## 复合应用 + * [视频修复](./docs/zh_CN/tutorials/video_restore.md) -## 在线体验 +## 在线教程 -通过[AI Studio实训平台](https://aistudio.baidu.com/aistudio/index)在线体验: +您可以通过[人工智能学习与实训社区AI Studio](https://aistudio.baidu.com/aistudio/index) 的示例工程在线体验PaddleGAN的部分能力: |在线教程 | 链接 | |--------------|-----------| |老北京视频修复|[点击体验](https://aistudio.baidu.com/aistudio/projectdetail/1161285)| |表情动作迁移-当苏大强唱起unravel |[点击体验](https://aistudio.baidu.com/aistudio/projectdetail/1048840)| +## 效果展示 + +### 图片变换 + +
+ +
+ +### 老视频修复 + +
+ +
+ + +### 动作迁移 + +
+ +
+ +### 超分辨率 + +
+ +
+ + +### 妆容迁移 + +
+ +
+ ## 版本更新 @@ -86,10 +90,24 @@ PaddleGAN 是一个基于飞桨的生成对抗网络开发工具包. - 初版发布，支持Pixel2Pixel、CycleGAN、PSGAN模型，支持视频插针、超分、老照片/视频上色、视频动作生成等应用。 - 模块化设计，接口简单易用。 +## PaddleGAN 特别兴趣小组（Special Interest Group） + +最早于1961年被[ACM（Association for Computing Machinery)](https://en.wikipedia.org/wiki/Association_for_Computing_Machinery)首次提出并使用，国际顶尖开源组织包括[Kubernates](https://kubernetes.io/)都采用SIGs的形式，使拥有同样特定兴趣的成员可以共同分享、学习知识并进行项目开发。这些成员不需要在同一国家/地区、同一个组织，只要大家志同道合，都可以奔着相同的目标一同学习、工作、玩耍~ + +PaddleGAN SIG就是这样一个汇集对GAN感兴趣小伙伴们的开发者组织，在这里，有百度飞桨的一线开发人员、有来自世界500强的资深工程师、有国内外顶尖高校的学生。 + +我们正在持续招募有兴趣、有能力的开发者加入我们一起共同建设本项目，并一起探索更多有用、有趣的应用。 + +[PaddleGAN QQ 群号：1058398620] + +
+ +
## 贡献代码 我们非常欢迎您可以为PaddleGAN提供任何贡献和建议。大多数贡献都需要同意参与者许可协议（CLA）。当提交拉取请求时，CLA机器人会自动检查您是否需要提供CLA。 只需要按照机器人提供的说明进行操作即可。CLA只需要同意一次，就能应用到所有的代码仓库上。关于更多的流程请参考[贡献指南](docs/zh_CN/contribute.md)。 ## 许可证书 + 本项目的发布受[Apache 2.0 license](LICENSE)许可认证。 diff --git a/README_en.md b/README_en.md index 5dfd6f10e82633820710427277ab20a60cae9f9c..6b103497ed6044c957954fa6aeb224410d2300a2 100644 --- a/README_en.md +++ b/README_en.md @@ -1,86 +1,99 @@ -
- -
English | [简体中文](./README.md) # PaddleGAN -PaddleGAN is a software development kit of Generative Adversarial Network based on PaddlePaddle. +PaddleGAN provides developers with high-performance implementation of classic and SOTA Generative Adversarial Networks, and support developers to quickly build, train and deploy GANs for academic, entertainment and industrial usage. + +GAN-Generative Adversarial Network, was praised by "the Father of Convolutional Networks" **Yann LeCun (Yang Likun)** as **[One of the most interesting ideas in the field of computer science in the past decade]**. It's one the research area in deep learning that AI researchers are most concerned about. -### Image Translation
- +
+[![License](https://img.shields.io/badge/license-Apache%202-red.svg)](LICENSE)![python version](https://img.shields.io/badge/python-3.6+-orange.svg) -### Makeup shifter -
- -
+## Quick Start +* Please refer [install](./docs/en_US/install.md) to ensure you sucessfully installed PaddlePaddle and PaddleGAN. + +* Get started through ppgan.app interface: + + ```python + from ppgan.apps import RealSRPredictor + sr = RealSRPredictor() + sr.run("docs/imgs/monarch.png") + ``` + +* More tutorials: + - [Data preparation](./docs/en_US/data_prepare.md) + - [Training/Evaluating/Testing basic usage](./docs/zh_CN/get_started.md) + +## Model Tutorial + +* [Pixel2Pixel](./docs/en_US/tutorials/pix2pix_cyclegan.md) +* [CycleGAN](./docs/en_US/tutorials/pix2pix_cyclegan.md) +* [PSGAN](./docs/en_US/tutorials/psgan.md) +* [First Order Motion Model](./docs/en_US/tutorials/motion_driving.md) + +## Composite Application + +* [Video restore](./docs/zh_CN/tutorials/video_restore.md) + +## Examples + +### Image Translation -### Old video restore
- +
-### Super resolution - +### Old video restore
- +
+ ### Motion driving
-Features: - -- Highly Flexible: +### Super resolution - Components are designed to be modular. Model architectures, as well as data -preprocess pipelines, can be easily customized with simple configuration -changes. +
+ +
-- Rich applications: - PaddleGAN provides rich of applications, such as image generator, image restorer, image colorizer, video interpolator, makeup shifter. +### Makeup shifter -## Install +
+ +
-Please refer to [install](./docs/en_US/install.md). -## Quick Start +## Changelog -Get started through ppgan.app interface: +- v0.1.0 (2020.11.02) + - Release first version, supported models include Pixel2Pixel, CycleGAN, PSGAN. Supported applications include video frame interpolation, super resolution, colorize images and videos, image animation. + - Modular design and friendly interface. - ```python - from ppgan.apps import RealSRPredictor - sr = RealSRPredictor() - sr.run("docs/imgs/monarch.png") - ``` +## PaddleGAN Special Interest Group（SIG） -More tutorials: +It was first proposed and used by [ACM（Association for Computing Machinery)](https://en.wikipedia.org/wiki/Association_for_Computing_Machinery) in 1961. Top International open source organizations including [Kubernates](https://kubernetes.io/) all adopt the form of SIGs, so that members with the same specific interests can share, learn knowledge and develop projects. These members do not need to be in the same country/region or the same organization, as long as they are like-minded, they can all study, work, and play together with the same goals~ -- [Data preparation](./docs/en_US/data_prepare.md) -- [Training/Evaluating/Testing basic usage](./docs/zh_CN/get_started.md) +PaddleGAN SIG is such a developer organization that brings together people who interested in GAN. There are frontline developers of PaddlePaddle, senior engineers from the world's top 500, and students from top universities at home and abroad. -## Model Tutorial +We are continuing to recruit developers interested and capable to join us building this project and explore more useful and interesting applications together. -* [Pixel2Pixel](./docs/en_US/tutorials/pix2pix_cyclegan.md) -* [CycleGAN](./docs/en_US/tutorials/pix2pix_cyclegan.md) -* [PSGAN](./docs/en_US/tutorials/psgan.md) -* [First Order Motion Model](./docs/en_US/tutorials/motion_driving.md) -* [Video restore](./docs/zh_CN/tutorials/video_restore.md) +[PaddleGAN QQ Group：1058398620] +
+ +
-## Changelog -- v0.1.0 (2020.11.02) - - Release first version, supported models include Pixel2Pixel, CycleGAN, PSGAN. Supported applications include video frame interpolation, super resolution, colorize images and videos, image animation. - - Modular design and friendly interface. ## Contributing diff --git a/docs/imgs/color_sr_peking.gif b/docs/imgs/color_sr_peking.gif index 9792390cf4fcc2677c248e1d01ee7c1a262a553e..2e9e4428599732a3e613b8c68cb8c9826c593b50 100644 Binary files a/docs/imgs/color_sr_peking.gif and b/docs/imgs/color_sr_peking.gif differ diff --git a/docs/imgs/makeup_shifter.png b/docs/imgs/makeup_shifter.png index 63cb5626de74175e74f254d2fdeb951c6afc9e8e..5f11a7d352ec4c6fe2a04c851c42d7508fb5f53b 100644 Binary files a/docs/imgs/makeup_shifter.png and b/docs/imgs/makeup_shifter.png differ diff --git a/docs/imgs/ppgan.jpg b/docs/imgs/ppgan.jpg index 8e1150448612f7aed25aaa883da8722cbebd9e15..d3d0d2995cf9b3f2a266e0293e61740dc6bcb6a5 100644 Binary files a/docs/imgs/ppgan.jpg and b/docs/imgs/ppgan.jpg differ diff --git a/docs/imgs/qq.png b/docs/imgs/qq.png new file mode 100644 index 0000000000000000000000000000000000000000..ec94f43ef566b8b92c4713b67563f5251e022f6e Binary files /dev/null and b/docs/imgs/qq.png differ