Skip to content
jenni is a python IRC bot maintained and developed by Michael Yanovich. This project was created by Sean B. Palmer.
Find file
Latest commit 2d00c50 May 5, 2016 @myano added ability to block auto-titles without having to disable the entire
url module

this is great for channels where you want to be able to use .title but
don't want to have jenni be annoying with auto-title


jenni is a python IRC bot maintained and developed by Michael Yanovich. This project was originally created by Sean B. Palmer.

Installation & Configuration

jenni requires python 2.7, jenni will not work with python 3.x.

  1. Run ./jenni - this creates a default config file
  2. Edit ~/.jenni/
  3. Run ./jenni - this now runs jenni with your settings


Optional Dependencies

From Pip:

  • feedparser - allows the optional and modules to work.
  • BeautifulSoup - allows better output from DuckDuckGo in, image_me module and animate_me_module to work, and allow more in-depth results for .calc
  • yelpapi - allows you to use the food module

Google Developer API Key

The YouTube module requires that you have a Google Developer API key in order to function. This key can be obtained by:

  1. Go to the Google Developer Console at:
  2. Create or select a project.
  3. In the sidebar on the left, expand APIs & auth. Next, click APIs. In the list of APIs, find and ensure that the YouTube Data API is enabled.
  4. In the sidebar on the left, select Credentials.
  5. Create a new Public API access key and choose Server Key. Copy the created API Key into the google_dev_apikey option in your config.

Best Practices

  • Give jenni '@' (ops) at your risk. This software is provided without warranty, without exception.
  • You can no longer run jenni as the root user (euid = 0).
    • This is a huge security risk, amplifying the impact of any potential vulnerability.

Additional Info

See for information about jenni/Phenny modules


For a list of contributions to the jenni fork see the file CREDITS.

Sean B. Palmer, forked by Michael Yanovich,

Something went wrong with that request. Please try again.