Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

poem

A poem generator that knows exactly three words: ash, vinyl, light.

$ poem

Vinyl In The Light
------------------
the vinyl remembers the needle's weight
the light falls on a stack of used vinyls
we are made of ash, vinyl, and light
somewhere a ash is waiting for a person who has time
nothing is on fire, the light is just bright

Why three words?

Because constraints make better work. Give a generator the whole dictionary and it becomes an algorithm. Give it three words and it becomes a poet — or at least, a very sincere accountant of feelings.

The three words are not arbitrary:

  • ash — what's left when the thing is finished
  • vinyl — the grooves that hold the sound of the past
  • light — the only thing that moves through all of it

Install

pip install .        # or just:
chmod +x poem.py && ln -s "$(pwd)/poem.py" /usr/local/bin/poem

Zero dependencies. Python 3.8+.

Usage

poem                          # default words: ash vinyl light
poem river stone window       # your own words
poem --lines 7                # longer poems
poem --seed 42                # reproducible poems
poem --list                   # show the known lines

The rules

  1. It knows three words. No more.
  2. Every line is true, or it doesn't ship.
  3. Never deploy to a song you won't remember hearing.

License

MIT — take it, fork it, teach it new words.

About

a poem generator that knows exactly three words

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages