Create README.md
Browse files
README.md
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language:
|
| 3 |
+
- en
|
| 4 |
+
license: apache-2.0
|
| 5 |
+
tags:
|
| 6 |
+
- text-to-image
|
| 7 |
+
- image-generation
|
| 8 |
+
- flux
|
| 9 |
+
---
|
| 10 |
+
# FLUX.1 [schnell]
|
| 11 |
+
|
| 12 |
+
> **Note:** This is an **archived / mirror repository**, **not** the original upstream source.
|
| 13 |
+
> All official updates, releases, and maintenance are handled by **Black Forest Labs**.
|
| 14 |
+
|
| 15 |
+
`FLUX.1 [schnell]` is a 12-billion-parameter rectified flow transformer capable of generating high-quality images from text descriptions.
|
| 16 |
+
|
| 17 |
+
**Official Announcement:**
|
| 18 |
+
🔗 https://blackforestlabs.ai/announcing-black-forest-labs/
|
| 19 |
+
|
| 20 |
+
## Official Upstream Sources
|
| 21 |
+
|
| 22 |
+
- **FLUX.1-schnell — black-forest-labs (original Hugging Face model)**
|
| 23 |
+
https://huggingface.co/black-forest-labs/FLUX.1-schnell
|
| 24 |
+
|
| 25 |
+
# Key Features
|
| 26 |
+
1. Cutting-edge output quality and competitive prompt following, matching the performance of closed source alternatives.
|
| 27 |
+
2. Trained using latent adversarial diffusion distillation, `FLUX.1 [schnell]` can generate high-quality images in only 1 to 4 steps.
|
| 28 |
+
3. Released under the `apache-2.0` licence, the model can be used for personal, scientific, and commercial purposes.
|
| 29 |
+
|
| 30 |
+
## Usage
|
| 31 |
+
|
| 32 |
+
A full reference implementation of `FLUX.1 [schnell]`, including sampling code, is available in the official GitHub repository:
|
| 33 |
+
https://github.com/black-forest-labs/flux
|
| 34 |
+
|
| 35 |
+
Developers and creators should rely on the upstream GitHub repository when building applications, tools, or fine-tuning pipelines.
|
| 36 |
+
|
| 37 |
+
## ComfyUI
|
| 38 |
+
`FLUX.1 [schnell]` is also available in [Comfy UI](https://github.com/comfyanonymous/ComfyUI) for local inference with a node-based workflow.
|
| 39 |
+
|
| 40 |
+
## Diffusers
|
| 41 |
+
To use `FLUX.1 [schnell]` with the 🧨 diffusers python library, first install or upgrade diffusers
|
| 42 |
+
|
| 43 |
+
```shell
|
| 44 |
+
pip install -U diffusers
|
| 45 |
+
```
|
| 46 |
+
|
| 47 |
+
Then you can use `FluxPipeline` to run the model
|
| 48 |
+
|
| 49 |
+
```python
|
| 50 |
+
import torch
|
| 51 |
+
from diffusers import FluxPipeline
|
| 52 |
+
pipe = FluxPipeline.from_pretrained("black-forest-labs/FLUX.1-schnell", torch_dtype=torch.bfloat16)
|
| 53 |
+
pipe.enable_model_cpu_offload() #save some VRAM by offloading the model to CPU. Remove this if you have enough GPU power
|
| 54 |
+
prompt = "A cat holding a sign that says hello world"
|
| 55 |
+
image = pipe(
|
| 56 |
+
prompt,
|
| 57 |
+
guidance_scale=0.0,
|
| 58 |
+
num_inference_steps=4,
|
| 59 |
+
max_sequence_length=256,
|
| 60 |
+
generator=torch.Generator("cpu").manual_seed(0)
|
| 61 |
+
).images[0]
|
| 62 |
+
image.save("flux-schnell.png")
|
| 63 |
+
```
|
| 64 |
+
|
| 65 |
+
To learn more check out the [diffusers](https://huggingface.co/docs/diffusers/main/en/api/pipelines/flux) documentation
|
| 66 |
+
|
| 67 |
+
---
|
| 68 |
+
# Limitations
|
| 69 |
+
- This model is not intended or able to provide factual information.
|
| 70 |
+
- As a statistical model this checkpoint might amplify existing societal biases.
|
| 71 |
+
- The model may fail to generate output that matches the prompts.
|
| 72 |
+
- Prompt following is heavily influenced by the prompting-style.
|
| 73 |
+
|
| 74 |
+
# Out-of-Scope Use
|
| 75 |
+
The model and its derivatives may not be used
|
| 76 |
+
|
| 77 |
+
- In any way that violates any applicable national, federal, state, local or international law or regulation.
|
| 78 |
+
- For the purpose of exploiting, harming or attempting to exploit or harm minors in any way; including but not limited to the solicitation, creation, acquisition, or dissemination of child exploitative content.
|
| 79 |
+
- To generate or disseminate verifiably false information and/or content with the purpose of harming others.
|
| 80 |
+
- To generate or disseminate personal identifiable information that can be used to harm an individual.
|
| 81 |
+
- To harass, abuse, threaten, stalk, or bully individuals or groups of individuals.
|
| 82 |
+
- To create non-consensual nudity or illegal pornographic content.
|
| 83 |
+
- For fully automated decision making that adversely impacts an individual's legal rights or otherwise creates or modifies a binding, enforceable obligation.
|
| 84 |
+
- Generating or facilitating large-scale disinformation campaigns.
|