Skip to content

[docs] Quickstart #12128

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Aug 15, 2025
Merged

[docs] Quickstart #12128

merged 4 commits into from
Aug 15, 2025

Conversation

stevhliu
Copy link
Member

Refactors the Quickstart to provide a more complete snapshot of what Diffusers offers rather than focusing on how the components in a pipeline works. It was a good opportunity to include/link to some of the cool optimization stuff @sayakpaul and @a-r-r-o-w have been working on, which I consider to be a pretty important aspect of the library.

This is a pretty high visibility doc, so let me know if there is anything else you think we should include or is missing. For example, should we include Hybrid inference and Modular Diffusers, or are these more experimental still?

@HuggingFaceDocBuilderDev

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.

Copy link
Member

@a-r-r-o-w a-r-r-o-w left a comment

Choose a reason for hiding this comment

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

Thanks @stevhliu, looks good!

@asomoza
Copy link
Member

asomoza commented Aug 12, 2025

this is just my opinion and maybe an unpopular one too, but since we're a fully open source library with an apache 2.0 license and this is the entry point for most users, we probably should also do an example with a similar model, using a non-commercial and gated repo for the beginners is not an ideal UX or a showcase for those that want to use diffusers in a commercial product.

@stevhliu
Copy link
Member Author

Happy to add an example with a similar model, did you have one in mind?

@asomoza
Copy link
Member

asomoza commented Aug 13, 2025

Qwen-Image seems like a good alternative right now, it has the first trending position for image generation models and it's third overall.

Same for HunyuanVideo, WAN 2.2 is a lot more popular with an Apache 2.0 license and while HunyuanVideo is not a gated repo, it has a custom license.

Copy link
Member

@sayakpaul sayakpaul left a comment

Choose a reason for hiding this comment

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

Thanks for getting this started!

@stevhliu
Copy link
Member Author

Updated to use Qwen-Image and Wan 2.2!

Copy link
Member

@sayakpaul sayakpaul left a comment

Choose a reason for hiding this comment

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

Just a nit about trying to reduce LoC in the snippets when it is applicable. We can batch these updates in a future PR as well.

LGTM!

Comment on lines 55 to 58
pipeline = DiffusionPipeline.from_pretrained(
"Qwen/Qwen-Image",
torch_dtype=torch.bfloat16
).to("cuda")
Copy link
Member

Choose a reason for hiding this comment

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

Nit:

Suggested change
pipeline = DiffusionPipeline.from_pretrained(
"Qwen/Qwen-Image",
torch_dtype=torch.bfloat16
).to("cuda")
pipeline = DiffusionPipeline.from_pretrained(
"Qwen/Qwen-Image", torch_dtype=torch.bfloat16
).to("cuda")

Copy link
Member

Choose a reason for hiding this comment

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

how about using the new device_map="cuda" when loading the pipelines?

Copy link
Member Author

Choose a reason for hiding this comment

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

Updated to use device_map="cuda" in the recently refreshed docs to increase visibility :)

@stevhliu stevhliu merged commit a58a4f6 into huggingface:main Aug 15, 2025
1 check passed
@stevhliu stevhliu deleted the quicktour branch August 15, 2025 20:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants