flux1-cli - GitLite

KO | EN

gitlite — search

#ai-agents #tailwindcss #claude #generative-ai #video #electron #mysql #chatbot #sql #containers

flux1-cli

(★ 11)

Easy local FLUX.1 Inference

File Explorer

ZIP Download

- .gitkeep
- .gitkeep
- app_config.py
- flux.py
- flux_config.py
- flux_pipeline.py
- main.py
- torch_helper.py
.gitignore
banner.png
LICENSE.md
README.md
requirements.in
requirements.txt

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`git clone`

View Details ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

`python3`

View Details ▼

This command is an alias of `python`.

tldr python

View documentation for the original command:

🔍

`uv pip`

View Details ▼

Provides pip-like commands for installing, uninstalling, and managing packages.

uv pip install {{package}}

Install a package:

uv pip install {{[-r|--requirements]}} {{requirements.txt}}

Install packages from a requirements file:

uv pip install {{package==1.2.3}}

Install a package with a specific version:

🔍

`uv venv`

View Details ▼

Create an isolated Python environment for installing packages.

uv venv

Create a virtual environment in the default location (`.venv`):

uv venv {{path/to/venv}}

Create a virtual environment at a specific path:

uv venv {{[-p|--python]}} {{3.12}}

Create using a specific Python version:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> Supports MPS (Apple Silicon), CUDA and CPU

![](https://raw.githubusercontent.com/SplittyDev/flux1-cli/main/banner.png)

## Features

- **Multiple Models**: Supports FLUX.1-schnell and FLUX.1-dev
- **LoRA Support**: Interactive LoRA picker for easy selection
- **Cross-Platform**: Supports MPS, CUDA and CPU
- **Tested on macOS**: Works well on Apple Silicon[^1]

## Installation

**Cloning the repository**:
```bash
git clone https://github.com/SplittyDev/flux1-cli.git
cd flux1-cli
```

**Using uv (recommended)**:
```bash
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
python3 src/main.py
```

**Using pip**:
```bash
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
python3 src/main.py
```

### Installing LoRAs

Simply put your `.safetensors` files in the `lora` directory.  
They will be available immediately when typing `/lora`.

## Prompting

### Inference Modifiers

The CLI supports various modifiers, which can be added to the end of the prompt, like this:
- `Photograph of a meadow in a forest /fast`
- `Photograph of a meadow in a forest /1024x768 /slow`
- `Photograph of a meadow in a forest /seed=1234 /8`

**List of Modifiers**:

| Modifier           | Description                                                |
|--------------------|------------------------------------------------------------|
| `/f`, `/fast`      | Use a small number of inference steps for fast results     |
| `/s`, `/slow`      | Use a large number of inference steps for accurate results |
| `/a`, `/again`     | Reuse the previous seed for the next inference             |
| `/r`, `/random`    | Use a random seed for the next inference                   |
| `/<n>` if n < 128  | Use this number of inference steps for the next inference  |
| `/<n>` if n >= 128 | Set the resolution to `nxn`                                |
| `/<w>x<h>`         | Set the resolution to `wxh`                                |

### Standalone Modifiers

The CLI also supports standalone modifiers, which only work on their own line.

**List of Standalone Modifiers**:

| Modifier              | Description                   |
|-----------------------|-------------------------------|
| `/quit`               | Quit the CLI                  |
| `/lora`               | Show LoRA picker              |
| `/lora_scale=<scale>` | Set the LoRA scale to `scale` |
| `/seed=<seed>`        | Set the seed to `seed`        |

### Tips and Tricks

- Leaving the prompt completely empty will repeat the last prompt
- You can combine modifiers, like this: `Photograph of a meadow in a forest /fast /seed=1234`
- You can apply new modifiers without repeating the prompt, like this: `/slow /1024x768`
- Images are saved in this format: `output/<date>/<timestamp>_<seed>.png`

### Example workflows with modifiers

**Annotated example, explaning the thought process**

```ini
# Initial prompt. Generate images fast, to get a feeling for the prompt.
λ Prompt: Photograph of a meadow in a forest /fast
# Refine prompt. Fast mode is still active, no need to repeat it.
λ Prompt: High resolution photograph of a meadow in a forest
# This looks nice! Let's generate the same image again, but in slow mode.
λ Prompt: /again /slow
# Let's keep the same prompt, but randomize the seed again.
λ Prompt: /random
# Let's try it in landscape mode, but fast, to see if it looks better.
λ Prompt: /1920x1080 /fast
# Alright, let's call it a day
λ Prompt: /quit
```

**Real-world example, using shortcuts and no comments**

```ini
λ Prompt: Photograph of a moonlit meadow in a mythical forest/f
λ Prompt: 
λ Prompt: /a/s
λ Prompt: Stunning photograph of a moonlit meadow in a mythical forest, godrays/r/f
λ Prompt: /a/s
λ Prompt: /quit
```

## Troubleshooting

**I don't have enough VRAM**:
> You can pass the `--offload-cpu` flag to offload parts of the model to the CPU for lower VRAM usage with a small performance hit. Sadly this doesn't seem to work with MPS. If anyone knows why, please let me know!

**I wanna use the CPU (for whatever reason)**:
> You can pass the `--force-cpu` flag to force CPU inference. This is not recommended, as it's _much_ slower than MPS or CUDA.

**High resolution images are broken**
> FLUX.1 has a maximum resolution of 2MP. These are _roughly_ the largest possible sizes[^2]:
> - 1:1 exact 1448 x 1448, rounded 1408 x 1408
> - 3:2 exact 1773 x 1182, rounded 1728 x 1152
> - 4:3 exact 1672 x 1254, rounded 1664 x 1216
> - 16:9 exact 1936 x 1089, rounded 1920 x 1088
> - 21:9 exact 2212 x 948, rounded 2176 x 960
>
> You can use an upscaler (not included) to increase the resolution.

[^1]: Tested on 2023 Mac Studio, 128GB Unified RAM, 24-Core Apple M2 Ultra
[^2]: See [this post on Reddit](https://www.reddit.com/r/StableDiffusion/comments/1enxdga/flux_recommended_resolutions_from_01_to_20/). Thanks `u/Aplakka`!