Nefarious Planetary Meddling


    0.3.0 • Public • Published


    poem-gen is a poem generator created for NaNoGenMo 2014 by Camden Segal. It uses large source texts from Project Gutenberg to make poems.

    How It Works

    The source texts are converted into word maps - each word is linked with all words that are used before it - so the generator can imitate the usage of the word from the source text.

    Then a random word with existent rhymes in the source text is chosen as the first word of the poem. Each line is built from last word to first word using the word map. Words are added till the number of desired syllables is met.

    This process is repeated for each line within the confines of the chosen rhyming scheme. Rhyme scheme, source text, and length are customizable.


    To install the command line client:

    npm install -g poem-gen

    poem-gen can also be used as a module in other node projects if you install it locally:

    npm install poem-gen


    CLI Options

    -h, --help             output usage information
    -V, --version          output the version number
    -d, --data [file]      Use built in data file [all]
    -f, --file [file]      Use specific source file
    -r, --repeats [count]  Times to repeat rhyming scheme
    -w, --words [count]    Poem word length (overrides repeats)
    -v, --verbose          Show extra info
    -s, --scheme [scheme]  Scheme name or pattern

    Data sets

    Used with the -d option. Like $ poem -d spooky/moby-dick

    • all - All texts combined together.
    • epic
      • epic/gullivers-travels
      • epic/oliver-twist
      • epic/tale-of-two-cities
    • romance
      • romance/jane-austen
      • romance/kamasutra
    • spooky
      • spooky/dracula
      • spooky/frankenstein
      • spooky/moby-dick
      • spooky/poe
      • spooky/sleepy-hallow
    • weird
      • weird/pizza
      • weird/ulysses

    Rhyming Schemes

    Used with the -s option. Like $ poem -s limerick.

    You can also specify a custom scheme in the format of "aX" where a is any character for use as a rhyming group specifier and X is the number of syllables.

    So $ poem -s "a5 b10 a7" would generate a three line poem:

    • The first line would be five syllables
    • The second line would be ten syllables
    • And the third line would be 7 syllables and would rhyme with the first line.

    Built in schemes:

    • sonnet - a10 b10 a10 b10 c10 d10 c10 d10 e10 f10 e10 f10 g10 g10
    • haiku - a5 b7 c5
    • couplet - a8 a8
    • triplet - a8 a8 a8
    • alternating - a8 b8 a8 b8
    • limerick - a9 a9 b6 b6 a9


    npm i poem-gen

    DownloadsWeekly Downloads






    Unpacked Size

    48.1 MB

    Total Files


    Last publish


    • avatar