contrastive-unpaired-translation

不用配对数据,训练速度比CycleGAN快一倍,图像翻译效果更好

CUT(Contrastive Unpaired Translation)是一个基于对比学习的无配对图像到图像翻译框架,由Taesung Park等人于ECCV 2020提出。它解决了传统无监督翻译模型(如CycleGAN)训练成本高、需要循环一致性约束导致生成结果过于保守的问题。核心思想是利用对比学习在特征空间中拉近输入与输出图像的对应块,同时推开非对应块,从而仅用单侧生成器即可完成翻译,无需循环重建。项目提供PyTorch实现,支持多种任务(如语义标签转街景、斑马转马、猫转狗等),训练速度比CycleGAN快约2倍,显存占用更少,生成质量更高。代码结构清晰,包含训练、测试、评估脚本,并支持自定义数据集。

开源 free 图像生成
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2553
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类图像生成
开发团队taesungp
所属国家
定价模式free
价格说明开源项目,基于PyTorch实现,可自行部署使用,完全免费。
访问状态
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型computer-graphics,computer-vision,computervision,cyclegan,deeplearning,gans,generative-adversarial-network,image-generation,image-manipulation,pytorch
GitHub 星标★ 2553
30天Star增速
HF 下载量
上线时间2020-07-21 00:00:00
最近更新2026-09-23 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:进阶 约 20 分钟 部署方式:本地安装 5 步

环境要求

  • 已安装 Python 与 pip(用于 pip 方式安装依赖)
  • 已安装 Git(用于克隆仓库)
  • PyTorch 1.1(README 明确要求该版本)
  • 若用 Conda 方式需预先安装 conda
  • 训练推荐具备 NVIDIA GPU(项目为图像生成模型)

安装与启动步骤

  1. 1克隆仓库

    把官方仓库克隆到本地并命名为 CUT 目录,需要能访问 GitHub,网络不通时可配置代理。

    git clone https://github.com/taesungp/contrastive-unpaired-translation CUT
  2. 2进入项目目录

    后续所有安装命令都要在 CUT 目录下执行,注意当前工作目录是否正确。

    cd CUT
  3. 3pip 安装依赖

    pip 用户执行该命令安装 torchvision、visdom、dominate、gputil 等依赖,需先自行装好 PyTorch 1.1。

    pip install -r requirements.txt
  4. 4Conda 安装依赖

    Conda 用户的替代方案,会依据 environment.yml 新建一个环境,与上一步二选一即可。

    conda env create -f environment.yml
  5. 5安装 FID 评估依赖

    若要评估 FID 指标,需额外安装 pytorch-fid,不评估可跳过这一步。

    pip install pytorch-fid

如何确认成功

README 节选未给出启动验证命令,pip/conda 安装过程无报错即表示依赖就绪;具体运行命令请查阅官方仓库的 train.py 与 test.py 说明。

常见问题

Q:pip 和 conda 两种安装方式该选哪个?

A:二选一即可。pip 用户执行 pip install -r requirements.txt;Conda 用户执行 conda env create -f environment.yml 新建环境,不要重复安装。

Q:需要安装哪个版本的 PyTorch?

A:README 明确写的是 PyTorch 1.1,以及 torchvision、visdom、dominate、gputil 等依赖,需先装好 PyTorch 再装其余依赖。

Q:怎么评测 FID 指标?

A:README 指出需先安装 pytorch-fid,即执行 pip install pytorch-fid,然后再按仓库脚本进行评测。

Q:必须要有 GPU 吗?

A:README 未直接说明,但该项目是图像生成模型,训练通常依赖 GPU;显存需求比 CycleGAN 更低。

注意事项

  • README 节选只包含克隆与依赖安装说明,未给出训练、测试的具体命令行,请以官方仓库脚本为准。
  • 安装命令必须在克隆得到的 CUT 目录内执行,否则找不到 requirements.txt 与 environment.yml。
  • pip 与 Conda 两种依赖安装方式择一即可,混用可能造成环境冲突。
  • 项目官网与论文链接:http://taesung.me/ContrastiveUnpairedTranslation/ 与 arXiv 2007.15651。

核心亮点

  • 训练速度比CycleGAN快约2倍,显存占用更低,适合资源有限场景
  • 无需循环一致性损失,生成结果更灵活,避免过度平滑
  • 基于对比学习的特征匹配,能保留输入图像的结构和内容,翻译更精准

不足之处

  • 对超参数(如lambda值、特征层选择)敏感,调参成本较高
  • 在复杂几何变化(如大姿态差异)下可能不如有监督方法稳定
  • 文档/社区待观察

适用场景

  • 无配对数据集下的图像风格迁移(如照片转油画、白天转黑夜)
  • 跨域图像生成(如语义分割图转真实街景)
  • 数据增强或域适配(如合成图像转真实图像)

替代项目

CycleGAN、UNIT、MUNIT

项目介绍

contrastive-unpaired-translation 是图像领域的开源项目,由 taesungp 开发,2020 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(2,553)位列前 30%,在图像分类的 837 个项目里位列前 8%。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-23。基于PyTorch实现,可自行部署使用,完全免费。

它主要面向的使用场景是:无配对数据集下的图像风格迁移(如照片转油画、白天转黑夜)。同类可对比的替代方案包括 CycleGAN、UNIT、MUNIT。

上一篇:collage-diffusion-ui

下一篇:ArtGAN

同类项目推荐

satori 开源

网页代码一键变高清图,放大不糊,不用截图

Enlightened library to convert HTML and CSS to SVG

★ 13967 2026-08-09
C2GAN 开源

用关键点精准控制图像生成,让AI画出你想要的结构

[ACM MM 2019 Oral] Cycle In Cycle Generative Adversarial Networks for Keypoint-Guide···

★ 70 2026-08-09
ComfyUI 开源

像搭积木一样连节点,生图流程自己搭

The most powerful and modular diffusion model GUI, api and backend with a graph/node···

★ 134493 2026-08-09