← all repositories
OsciiArt/DeepAA

ASCII art by neural network, because 2017 was weird

A NIPS workshop paper that taught CNNs to draw pictures with text characters—and left the repo half-finished.

1.6k stars Python Creative · Design
DeepAA
Velocity · 7d
+0.5
★ / day
Trend
steady
star history

What it does DeepAA converts grayscale line images into ASCII art using a convolutional neural network. You edit a hardcoded path in output.py, run it, and get a text-character rendering in an output/ directory. There’s also a lighter model if your GPU is feeling modest.

The interesting bit The actual research angle is the fun part: instead of hand-tuned algorithms, a CNN learns to pick which ASCII characters best preserve edges and texture. It was accepted to a NIPS 2017 creativity workshop, which tells you both that the idea was novel and that the implementation was never meant to be production infrastructure.

Key highlights

  • Pre-trained Keras/TensorFlow models; no training required to play around
  • “Light” model variant for less demanding hardware (added December 2017)
  • Published paper with actual academic backing: ASCII Art Synthesis with Convolutional Networks
  • Third-party web demo exists if you don’t want to fight dependencies
  • MIT licensed, including the pre-trained weights

Caveats

  • Dependencies frozen in 2017: TensorFlow 1.3.0, Keras 2.0.8, Pandas 0.18.0. Reproducing this today is archaeology, not installation.
  • README explicitly says “under construction” and the workflow is editing line 15 of a Python script
  • Requires grayscale line images; throw a photo at it and expect disappointment

Verdict Worth a look if you’re researching generative art, creative ML, or need a concrete “before diffusion models” reference. Skip it if you actually need ASCII art today—modern tools are less fussy and won’t ask you to downgrade half your Python stack.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.