Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Generates filks based on a poem format and corpus

Project Description


Generates silly poems based off of mad-libbed, serious poems, a tagged text corpus, and a pronunciation dictionary.


  1. Python 3.3+


To install:

pip install filks
filk install

The filk install step is not strictly necessary if you plan to use strictly a library and corpus you already have installed; however in most cases this will be most convenient. This step downloads the nltk library texts to your machine.


To generate a terrible poem:

filk format

See filk format -h for options.


To build the dev environment:

make venv
. venv/bin/activate


All original source code in this repo, including all *.py and configuration files, is released under the MIT license included.

However, this library relies on corpuses from nltk which may have a variety of free-ish licenses.

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(9.5 kB) Copy SHA256 Hash SHA256
Source None May 30, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers