Categorygithub.com/SethCurry/sdcli
modulepackage
0.0.1
Repository: https://github.com/sethcurry/sdcli.git
Documentation: pkg.go.dev

# README

sdcli

sdcli is a CLI application for generating images with the Stable Diffusion API.

PR's and issues are welcome. The current roadmap is roughly:

  • Support for image-to-image generation in SD3
  • Support for the other models offered (e.g. SD2, SDXL, etc).

Features

  • Generate and save images with the Stable Diffusion API
  • Saves the prompt you used to generate the image in exif metadata so you can reference it
  • Can invoke commands after generating an image to open it in an image viewer or editor

Installation

Binary releases are not currently implemented, though I would like to when I have time.

For now, you'll need a functional Go toolchain installed, and can then run:

go install github.com/SethCurry/sdcli

Configuration

Config is stored at ~/.config/sdcli/config.json (even on Windows, sorry ya'll).

Example config:

{
  // The Stability API key to use for billing
  "api_key": "YourAPIkeyHere",

  // The absolute or relative path to save images at when generating.
  // This does not expand ~ or environment variables.
  "output_directory": "/path/to/directory/to/store/files",

  // The command to run after generating an image.
  // The command will be invoked with a single positional argument,
  // the path to the file that was generated.
  //
  // I use this to open the images with Firefox after generation,
  // but a real image viewer or editor could also work.  You can
  // pass a path to a script if you need to provide additional
  // arguments to the application you want to run.
  "post_generation_command": "/usr/bin/firefox"
}

Usage

Generate a basic image with Stable Diffusion 3:

sdcli gen-3 A bear riding a unicycle in space

Generate an image with a different aspect ratio:

sdcli gen-3 --ratio 3:4 A bear riding a unicycle in space

You can also quote the prompt if you need to or don't want to escape characters:

sdcli gen-3 "A bear eating another bear's porridge"

# Packages

No description provided by the author

# Structs

No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author