whatisgithub

What is hy-wu?

tencent-hunyuan/hy-wu — explained in plain English

Analysis updated 2026-05-18

281PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

HY-WU is an open source AI research framework that edits images using text instructions, letting you transfer outfits, faces, or textures between photos without retraining the model.

Mindmap

mindmap
  root((HY-WU))
    What it does
      Text guided image editing
      Outfit and face transfer
      No fine tuning needed
    Tech stack
      Python
      PyTorch
      Gradio
    Use cases
      Virtual try on
      Face identity transfer
      Texture synthesis
    Audience
      AI researchers
      Image generation teams
    Setup
      Needs multiple GPUs
      Pip install requirements
      Optional web demo

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Transfer clothing from one photo onto a person in another photo for virtual try-on style experiments.

USE CASE 2

Swap a face's identity onto another image while preserving pose and background.

USE CASE 3

Research on-the-fly model adaptation without fine-tuning for large image generation models.

USE CASE 4

Generate high-fidelity texture synthesis or cosplay outfit transformations for research demos.

What is it built with?

PythonPyTorchGradioHugging Face

How does it compare?

tencent-hunyuan/hy-wulynote-ai/humanize-textagentic-in/elephant-agent
Stars281279278
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity5/53/52/5
Audienceresearcherresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires multiple high-end GPUs (at least 8x40GB or 4x80GB VRAM) to run the base model.

The README does not state a license, so terms of use are unclear.

So what is it?

HY-WU is a research framework for AI powered image editing using text instructions. The core capability it demonstrates is transferring visual attributes between images, for example taking an outfit from one photo and placing it onto a person in a different photo, or transferring a face's identity while keeping the background and pose unchanged. The technical problem it solves is a longstanding tradeoff in AI image generation: customizing a model to handle a specific input, like a particular person's outfit, normally requires fine tuning the model on that input, which is slow and expensive. HY-WU instead generates lightweight adapter weights on the fly for each individual request, based on the input images and a text instruction. These adapters modify the image generation process without permanently altering the underlying model. This means each image editing request can be processed independently without any training or optimization step at the time of use. The README shows several example use cases, including combining clothing across different images, cosplay outfit transfer, transferring a face's identity onto another image, and generating detailed textures. The project reports human evaluation results claiming it performs close to some of the strongest closed source commercial image models available, while remaining open source. The framework is built to scale up to very large base models, and the main checkpoint requires multiple high end GPUs to run due to the model's size, specifically at least 8 GPUs with 40GB of memory each, or 4 GPUs with 80GB each. The project includes example code and an optional web based demo interface. You would use this if you are an AI researcher studying image editing, personalization, or parameter generation, or if you want to run text guided image editing that involves transferring visual elements between images. It is written in Python and was published by Tencent's Hunyuan research team.

Copy-paste prompts

Prompt 1
Explain how HY-WU generates adapter weights on the fly instead of fine-tuning the base model.
Prompt 2
Walk me through setting up HY-WU and running infer.py to transfer clothing between two images.
Prompt 3
What GPU hardware do I need to run the HY-WU 80 billion parameter base model?
Prompt 4
Help me launch the HY-WU Gradio web demo for interactive image-to-image editing.

Frequently asked questions

What is hy-wu?

HY-WU is an open source AI research framework that edits images using text instructions, letting you transfer outfits, faces, or textures between photos without retraining the model.

What language is hy-wu written in?

Mainly Python. The stack also includes Python, PyTorch, Gradio.

What license does hy-wu use?

The README does not state a license, so terms of use are unclear.

How hard is hy-wu to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is hy-wu for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.