Skip to content

[docs] Adapters - #14842

Open
stevhliu wants to merge 5 commits into
huggingface:mainfrom
stevhliu:adapters
Open

stevhliu wants to merge 5 commits into
huggingface:mainfrom
stevhliu:adapters

Conversation

@stevhliu

Copy link
Copy Markdown
Member

Updates the Adapters and personalization docs so they read as a more coherent current guide:

  • the biggest change is creating a Legacy adapters doc and moving DreamBooth, Textual Inversion, and T2I-Adapter onto it (cc @asomoza, can you take a look here and confirm whether these techniques are still commonly used?)
  • the adapter docs open the same way so users don't have to relearn the page shape each time
  • include transformers more in the LoRA guide so its not so UNet focused

@github-actions github-actions Bot added size/L PR with diff > 200 LOC documentation Improvements or additions to documentation and removed size/L PR with diff > 200 LOC labels Sep 22, 2026
@HuggingFaceDocBuilderDev

Copy link
Copy Markdown

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@sayakpaul sayakpaul left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks. I left some comments.

Comment thread docs/source/en/training/dreambooth.md Outdated
[DreamBooth](https://huggingface.co/papers/2208.12242) is a training technique that updates the entire diffusion model by training on just a few images of a subject or style. It works by associating a special word in the prompt with the example images.

To load a trained checkpoint for inference, see [Load a DreamBooth adapter for inference](../using-diffusers/dreambooth).
To load a trained checkpoint for inference, see [Load a DreamBooth adapter for inference](../using-diffusers/legacy_adapters#dreambooth).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

DreamBooth, by no means, is a legacy technique. I would keep it out of the legacy section.

Comment thread docs/source/en/tutorials/using_peft_for_inference.md Outdated
Comment thread docs/source/en/tutorials/using_peft_for_inference.md Outdated
Comment thread docs/source/en/tutorials/using_peft_for_inference.md
Comment thread docs/source/en/tutorials/using_peft_for_inference.md Outdated
Comment thread docs/source/en/tutorials/using_peft_for_inference.md Outdated
Comment thread docs/source/en/tutorials/using_peft_for_inference.md
Comment on lines -366 to +416
pipeline("A bowl of ramen shaped like a cute kawaii bear, by Feng Zikai", cross_attention_kwargs={"scale": 1.0}).images[0]
pipeline("A bowl of ramen shaped like a cute kawaii bear, by Feng Zikai").images[0]

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because the adapter_weights was set above?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah!

Comment on lines +17 to +24
```text
control image --> ControlNet --> residuals
|
text --> encoder --------------+ |
v v
denoiser blocks
(frozen base)
```

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same. I don't think it's adding much. For example, what is "v"?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v is supposed to be an arrow showing it inserted into the denoiser block, but we can remove :)

@asomoza

asomoza commented Sep 23, 2026

Copy link
Copy Markdown
Member

thanks @stevhliu I agree with @sayakpaul dreambooth its still very popular and used, Textual Inversion, and T2I-Adapter on the other hand are rarely used anymore so I think it is fine to archive them.

@github-actions github-actions Bot added the size/L PR with diff > 200 LOC label Sep 23, 2026
@stevhliu
stevhliu requested a review from sayakpaul September 23, 2026 18:33

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/L PR with diff > 200 LOC

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants