shimmyshimmer commited on
Commit
9632143
·
verified ·
1 Parent(s): bc84ace

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +80 -0
README.md ADDED
@@ -0,0 +1,80 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ license: other
5
+ license_name: flux-1-dev-non-commercial-license
6
+ license_link: LICENSE.md
7
+ tags:
8
+ - text-to-image
9
+ - image-generation
10
+ - flux
11
+ base_model:
12
+ - black-forest-labs/FLUX.1-dev
13
+ ---
14
+
15
+ `FLUX.1 [dev]` is a 12 billion parameter rectified flow transformer capable of generating images from text descriptions.
16
+ For more information, please read our [blog post](https://blackforestlabs.ai/announcing-black-forest-labs/).
17
+ # Key Features
18
+ 1. Cutting-edge output quality, second only to our state-of-the-art model `FLUX.1 [pro]`.
19
+ 2. Competitive prompt following, matching the performance of closed source alternatives .
20
+ 3. Trained using guidance distillation, making `FLUX.1 [dev]` more efficient.
21
+ 4. Open weights to drive new scientific research, and empower artists to develop innovative workflows.
22
+ 5. Generated outputs can be used for personal, scientific, and commercial purposes as described in the [`FLUX.1 [dev]` Non-Commercial License](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md).
23
+ # Usage
24
+ We provide a reference implementation of `FLUX.1 [dev]`, as well as sampling code, in a dedicated [github repository](https://github.com/black-forest-labs/flux).
25
+ Developers and creatives looking to build on top of `FLUX.1 [dev]` are encouraged to use this as a starting point.
26
+ ## API Endpoints
27
+ The FLUX.1 models are also available via API from the following sources
28
+ - [bfl.ml](https://docs.bfl.ml/) (currently `FLUX.1 [pro]`)
29
+ - [replicate.com](https://replicate.com/collections/flux)
30
+ - [fal.ai](https://fal.ai/models/fal-ai/flux/dev)
31
+ - [mystic.ai](https://www.mystic.ai/black-forest-labs/flux1-dev)
32
+ ## ComfyUI
33
+ `FLUX.1 [dev]` is also available in [Comfy UI](https://github.com/comfyanonymous/ComfyUI) for local inference with a node-based workflow.
34
+ ## Diffusers
35
+ To use `FLUX.1 [dev]` with the 🧨 diffusers python library, first install or upgrade diffusers
36
+ ```shell
37
+ pip install -U diffusers
38
+ ```
39
+ Then you can use `FluxPipeline` to run the model
40
+ ```python
41
+ import torch
42
+ from diffusers import FluxPipeline
43
+ pipe = FluxPipeline.from_pretrained("black-forest-labs/FLUX.1-dev", torch_dtype=torch.bfloat16)
44
+ pipe.enable_model_cpu_offload() #save some VRAM by offloading the model to CPU. Remove this if you have enough GPU power
45
+
46
+ prompt = "A cat holding a sign that says hello world"
47
+ image = pipe(
48
+ prompt,
49
+ height=1024,
50
+ width=1024,
51
+ guidance_scale=3.5,
52
+ num_inference_steps=50,
53
+ max_sequence_length=512,
54
+ generator=torch.Generator("cpu").manual_seed(0)
55
+ ).images[0]
56
+ image.save("flux-dev.png")
57
+ ```
58
+ To learn more check out the [diffusers](https://huggingface.co/docs/diffusers/main/en/api/pipelines/flux) documentation
59
+
60
+ ---
61
+ # Limitations
62
+ - This model is not intended or able to provide factual information.
63
+ - As a statistical model this checkpoint might amplify existing societal biases.
64
+ - The model may fail to generate output that matches the prompts.
65
+ - Prompt following is heavily influenced by the prompting-style.
66
+
67
+ # Out-of-Scope Use
68
+ The model and its derivatives may not be used
69
+
70
+ - In any way that violates any applicable national, federal, state, local or international law or regulation.
71
+ - 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.
72
+ - To generate or disseminate verifiably false information and/or content with the purpose of harming others.
73
+ - To generate or disseminate personal identifiable information that can be used to harm an individual.
74
+ - To harass, abuse, threaten, stalk, or bully individuals or groups of individuals.
75
+ - To create non-consensual nudity or illegal pornographic content.
76
+ - For fully automated decision making that adversely impacts an individual's legal rights or otherwise creates or modifies a binding, enforceable obligation.
77
+ - Generating or facilitating large-scale disinformation campaigns.
78
+
79
+ # License
80
+ This model falls under the [`FLUX.1 [dev]` Non-Commercial License](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md).