https://github.com/adamelliotfields/gen-rs

A rusty image generation CLI
https://github.com/adamelliotfields/gen-rs

cli image-generation rust stable-diffusion txt2img

Last synced: 7 months ago
JSON representation

A rusty image generation CLI

• Host: GitHub
• URL: https://github.com/adamelliotfields/gen-rs
• Owner: adamelliotfields
• License: apache-2.0
• Created: 2024-10-23T15:07:53.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-02-20T20:13:45.000Z (8 months ago)
• Last Synced: 2025-02-20T21:24:47.967Z (8 months ago)
• Topics: cli, image-generation, rust, stable-diffusion, txt2img
• Language: Rust
• Homepage:
• Size: 62.5 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 9
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# gen-rs

A rusty generative AI CLI.

## Features

Run text and image generation models from various services.

**Supported:**

- [Hugging Face](https://huggingface.co): SDXL, SD 3.5 Large, SD 3.5 Large Turbo, FLUX.1 Dev, FLUX.1 Schnell

- [OpenAI](https://openai.com): DALL-E 2, DALL-E 3, GPT-4o

- [Together AI](https://together.ai): FLUX.1 Schnell, FLUX.1 Dev, FLUX.1 Pro, FLUX.1.1 Pro

## Usage

`cargo run -- --help`

```

Arguments:

  [PROMPT]  The text to guide the generation (required)

Options:

  -m, --model       Model to use

  -s, --service   Service to use

      --seed         Seed for reproducibility

  -t, --timeout   Timeout in seconds [default: 60]

  -q, --quiet              Suppress progress bar

      --debug              Use debug logging

      --list-models        Print models

      --list-services      Print services

  -h, --help               Print help

  -V, --version            Print version

Options (Image Generation):

  -n, --negative-prompt 

          Negative prompt

      --steps 

          Inference steps

      --cfg 

          Classifier-free guidance scale

      --width 

          Width of the image

      --height 

          Height of the image

      --style 

          Image style (OpenAI only) [default: vivid] [possible values: natural, vivid]

  -o, --out <OUT>

          Output file path [default: image.jpg]

Options (Text Generation):

      --system-prompt <SYSTEM_PROMPT>  Instructions that the model should follow

      --frequency <FREQUENCY>          Frequency penalty

      --presence <PRESENCE>            Presence penalty

      --temperature <TEMPERATURE>      Temperature

Environment Variables:

  HF_TOKEN                                 Required for Hugging Face

  OPENAI_API_KEY                           Required for OpenAI

  TOGETHER_API_KEY                         Required for Together.ai

```

## MSRV

The minimum supported Rust version is [1.80.0](https://blog.rust-lang.org/2024/07/25/Rust-1.80.0.html) for [LazyLock](https://doc.rust-lang.org/std/sync/struct.LazyLock.html).