ASCII Art Generator
Draw ASCII art by typing plain English: shapes, text, patterns, emoji faces, animals and your own images. It runs in the terminal, and in your browser with nothing to install.
Try it in your browser (nothing is uploaded; the Python runs on your machine)
In the browser, Copy as image copies a drawing as a picture with its colors, ready to paste into WhatsApp, Telegram or any other chat.
Quick start
pipx install "ascii-art-generator[all] @ git+https://github.com/JoaoTomas991/ascii-art-generator.git"
ascii-art-generator "draw a heart size 2 color red" # one command, then exit
ascii-art-generator # interactive menu
ascii-art-generator --intelligent # type commands freely
No Python? Download a ready-made executable for Windows, macOS (Apple Silicon) or Linux from Releases. Other ways to install, including Windows notes, are in docs/installation.md.
What it can do
- Shapes: rectangle, circle, triangle, heart, diamond, spiral, tree, star, hexagon, oval, arrow, pentagon, butterfly, flower.
- Text:
write HELLO with font slant, with real FIGlet fonts when pyfiglet is installed.
- Styling: colors (including
rainbow), 32 fill patterns and several border styles.
- Emoji and animals: a face with a mood (
draw a sad emoji), or a cat, dog, rabbit, owl and more.
- Images:
convert image photo.png width 80 color turns a picture into colored ASCII.
- Banners, boxes, patterns and small animations.
- Teachable moods:
teach ecstatic as happy, remembered between sessions.
Example commands
draw a rectangle 10x5
make a circle with radius 8 color blue
draw a heart size 4 color rainbow
write HELLO with font slant color cyan
make a rectangle 12x5 color cyan style dotted
draw a happy face
draw a big cat color yellow
make a circle with radius 5 color blue and a rectangle 10x5 color red
convert image /path/to/photo.png width 80 color
The full list of what is understood, the three ways to run it and the known limitations are in docs/usage.md.
Documentation
License
MIT; see LICENSE. Two bundled Claude Code skills by other authors keep their own licenses; see THIRD_PARTY_NOTICES.md.
