4 releases

0.2.6 Jul 23, 2023
0.2.5 Jul 23, 2023
0.2.0 Jul 20, 2023
0.1.0 Jul 14, 2023

#1659 in Text processing

MIT license

20KB
349 lines

Charisma

Retro Vintage Robot

Charisma serves a purpose of being a bridge between Dall-e mini. It's used to generate ASCII Art directly from your terminal. It uses Craiyon API to convert your words into reality. It's written in beloved rust with powerful tools come with it.

It's available as a rust crate on crates.io. For further implementation details please read the docs



Features

  • Free: No payment required for any feature
  • Fast: Algorithms parallelize in such a way that you can generate an image less than a second! (If you use -N 60 or more)
  • Simple: Homely CLI app with no bloat

Showcase

More





Getting started

Prerequisites

  • Cargo: This project is built and published using cargo package manager

Installation

cargo install charisma

Usage

charisma "rusty crab robot" -c -C block # Estimated time ~1min

Generate ASCII Art using AI 🦾🧠

Usage: charisma [OPTIONS] 

Arguments:
    Prompt to enter

Options:
  -n, --negative-prompt  Use AI to generate ascii art, but with a negative prompt [default: ]
  -N, --num-image                 Number of images to generate when using AI [1..9] [default: 9]
  -m, --model-type            Model to use in generation [default: general] [possible values: art, drawing, photo, general]
  -v                         Model API version [default: 3] [possible values: 1, 3]
  -a, --api-token                  API token for premium users (Faster generation, No watermark)
  -w, --width                      Width of the output image. Defaults to 128 if width and height are not specified
  -H, --height                    Height of the output image, if not specified, it will be calculated to keep the aspect ratio
  -c, --color                             Whether to use colors in the output image
  -i, --invert                            Inverts the weights of the characters. Useful for white backgrounds
  -C, --charset                  Characters used to render the image, from transparent to opaque. Built-in charsets: block, emoji, default, russian, slight [default: default]
  -h, --help                              Print help
  -V, --version                           Print version

Acknowledgments

Dependencies

~13–29MB
~347K SLoC