README.md

---
license: cc-by-nc-sa-4.0
base_model:
- Qwen/Qwen-Image-Edit
tags:
- automatic image enhancement
- image editing
---

<div align=center>
<img src="assets/logo.png" width="150px">
</div>
<h2 align="center"> 
  SmartPhotoCrafter: Unified Reasoning, Generation and Optimization for Automatic Photographic Image Editing
</h2>


<a href="https://arxiv.org/abs/2604.19587"><img src='https://img.shields.io/badge/arXiv-2501.11325-red?style=flat&logo=arXiv&logoColor=red' alt='arxiv'></a>&nbsp;
<a href="https://vivocameraresearch.github.io/smartphotocrafterweb"><img src='https://img.shields.io/badge/Project-Page-Green' alt='Project'></a>&nbsp;
<a href="https://huggingface.co/papers/2604.19587"><img src='https://img.shields.io/badge/🤗-HuggingFace-blue' alt='HuggingFace'></a>&nbsp;
<a href=""><img src='https://img.shields.io/badge/🤖-ModelScope-purple' alt='ModelScope'></a>&nbsp;
<a href="http://www.apache.org/licenses/LICENSE-2.0"><img src='https://img.shields.io/badge/License-CC BY--NC--SA--4.0-lightgreen?style=flat&logo=Lisence' alt='License'></a>&nbsp;

**SmartPhotoCrafter** is an end-to-end framework for automatic photographic image editing that reformulates traditional editing as a closed-loop reasoning-to-generation process. Unlike prior methods that rely on explicit user instructions, our approach autonomously identifies aesthetic deficiencies, reasons about improvement strategies, and performs targeted edits without human prompts.


## ✨ Highlights 
- **Fully Automatic Editing** – No user instructions or parameters required; the model completes the closed loop of quality assessment → reasoning → editing autonomously.
- **Dual Capability** – Supports both **image restoration** (denoising, deblurring, low-light enhancement) and **image retouching** (color, tone, contrast enhancement).
- **Aesthetic Reasoning** – Explicitly generates image quality analysis and editing suggestions, improving interpretability.
- **High-Fidelity Generation** – Preserves original content structure while delivering photo-realistic outputs with high tonal/color semantic sensitivity.
- **Reinforcement Learning Optimization** – Jointly optimizes reasoning and generation modules, aligning editing trajectories with human aesthetic preferences.

## 🖼️ Demo
![teaser](./assets/teaser.png)

## 🖼️ Demo Video
<a href="https://www.youtube.com/watch?v=2p3t1ju_CxA" target="_blank">
  <img src="assets/thumbnail.jpg" alt="SmartPhotoCrafter" width="760" height="450">
</a>


## ⭐ Code and Usage
The official code and model are available at the following GitHub repository:
https://github.com/vivoCameraResearch/SmartPhotoCrafter


## 📜 License 
All the materials, including code, checkpoints, and demos, are made available under the [Creative Commons BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) license. You are free to copy, redistribute, remix, transform, and build upon the project for non-commercial purposes, as long as you give appropriate credit and distribute your contributions under the same license.


## 🎓 Citation

```
@article{zeng2026smartphotocrafter,
  title={SmartPhotoCrafter: Unified Reasoning, Generation and Optimization for Automatic Photographic Image Editing},
  author={Zeng, Ying and Luo, Miaosen and Li, Guangyuan and Yang, Yang and Fan, Ruiyang and Shi, Linxiao and Yang, Qirui and Zhang, Jian and Liu, Chengcheng and Zheng, Siming and others},
  journal={arXiv preprint arXiv:2604.19587},
  year={2026}
}

```