goetry

README

goetry

poetry generation in golang

The goal of this project is to generate standard poetic forms (like sonnets, haikus, limericks, etc.) based on a corpus.

It will use a pronunciation dictionary (http://www.speech.cs.cmu.edu/cgi-bin/cmudict) achieve appropriate rhyming and metrical feet.

Status

No poetry - not yet!

There are basic commands for generating text based on an input corpus. Hopefully we'll get to poetry someday. Just not today.

How to run

Get a Corpus Ready

You'll need a basic corpus file in the following json format:

[
  {"Person": "Al", "Line": "Why am I soft in the middle?"},
  {"Person": "Al", "Line": "I can call you \"Betty;\" and, Betty, when you call me you can call me \"Al.\""}
]

Run a command

List People

If your corpus has multiple "persons" in it, this command will list you all the persons in the corpus.

Generate Sentences

You can run the generate-sentences command to generate n number of sentences.

Required: The corpus file Optional: Specific person (if unspecified, uses all the text in the corpus) Optional: Number of words (default 10)

Warning! If your corpus is small, or the specific person has very little training data, this command could result in an infinite loop.

Generate Words

You can run the generate-words command to generate n number of words.

Required: The corpus file Optional: Specific person (if unspecified, uses all the text in the corpus) Optional: Number of words (default 10)

List People

You can run the list-people command to get the list of people from your corpus. Helpful if you, like me, have used the scripts of all Star Trek TNG episodes, meaning many, many options with hard-to-remember spellings.

Required: The corpus file

Get Rhymes

You can run the get-rhymes command to get all of the words from your corpus that rhyme with an input word.

Required: The corpus file Required: The pronunciation dictionary file Required: The word to rhyme Optional: The minimum rhyme strength (roughly number of syllables that rhyme) Optional: The number of rhymes to return (default to 20, highest strength rhymes first)

find-missing-pronunciation

You can run the find-missing-pronunciation command to get all words from the corpus that are missing from the pronunciation dictionary.

Required: The corpus file Required: The pronunciation dictionary file