█████╗ ██████╗ ████████╗███████╗ ██████╗██╗██╗
██╔══██╗██╔══██╗╚══██╔══╝██╔════╝██╔════╝██║██║
███████║██████╔╝ ██║ ███████╗██║ ██║██║
██╔══██║██╔══██╗ ██║ ╚════██║██║ ██║██║
██║ ██║██║ ██║ ██║ ███████║╚██████╗██║██║
╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚══════╝ ╚═════╝╚═╝╚═╝
ARTSCII is a React-based AI Generative ASCII art generator. It uses the Dezgo API to generate images based off of your prompts and then converts the image to ASCII characters. It was created for Portland State University's CS-554 "Software Engineering" class in the Winter of 2023.
Note: You will need to sign up for a Dezgo API key in order to run this on your own machine.
- Clone or download this repo.
git clone https://github.com/elizasohn/artscii.git
- Install the node modules by navigating to root and running
npm install
- Create a file named .env and place it in the artscii folder.
[path_to_repository]/artscii/.env
- Create a variable for your Dezgo API key inside the .env file.
REACT_APP_STABLE_DIFFUSION_API_KEY = [your key here]
- Change into the artscii directory
cd [path_to_repo]/artscii
and run the projectnpm start
- If it does not open automatically: with the application running, navigate to localhost:3000 on a web browser like Chrome.
Try it out here! Simply enter a search term, wait for the resulting ai generated image and press "asciify" to see the glorious ascii results!