This command line tool uses AI to generate ascii art from a text prompt.
Artscii is a simple command line tool that:
- Makes a call to OpenAI's image generation API
- Converts the image to ascii using ascii-image-converter
- Outputs the ascii art to the command line
To install artscii with Homebrew, run:
brew install sweetkane/tap/artscii
Note: To use artscii, the OPENAI_API_KEY
environment variable must be set.
The most basic usage is to simply invoke the tool and supply a prompt. It will look like this:
artscii "a scene in the swiss alps"
You can specify many options to customize the way your image is converted to ascii. Add any number of these options after the prompt.
These options are actually passed directly to the ascii-image-converter
program, a third party dependency of artscii
with many options for customizing the output.
To output an image with color, you can run:
artscii "a scene in the swiss alps" --color
To use braille characters AND color, you can run:
artscii "a scene in the swiss alps" --braille --color
A full list of options can be found here
You can cache the OpenAI API response json, which contains a link to the raw image, by adding the -c
flag before the prompt.
It will look like this:
artscii -c "a scene in the swiss alps"
The cache will be created as artscii.cache.json
in your working directory. The program will append to the cache if one already exists.
https://github.com/TheZoraiz/ascii-image-converter
This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.