Public | Automated Build

Last pushed: 2 years ago
Short Description
a slack bot written in python.
Full Description

Project Raven (built on Limbo)

Based on the limbo slack client here:

A Slack <>__ chatbot


  1. Clone the repo
  2. Create a bot user <>__ if you
    don't have one yet, and copy the API Token
  3. export SLACK_TOKEN="your-api-token"
  4. run invoke && invoke to start the bot. That's it!

The above command actually does a few things, in this order

  • invoke install.pip (called by the below command) to install the required packages
  • invoke to install raven in development mode
  • invoke to actually serve the bot. You could also run python bin/raven to
    run the bot as well.
  1. Invite Raven into any channels you want it in, or just message it in
    #general. Try typing !gif dubstep cat to test it out

.. figure::
:alt: kitten mittens

kitten mittens


It's super easy to add your own commands! Just create a python file in
the plugins directory with an on_message function that returns a

You can use the !help command to print out all available commands
and a brief help message about them. !help <plugin> will return just
the help for a particular plugin.

These are the current default plugins:
[banner] <> *
calc <>
[echo] <> *
[flip] <>
gif <> *
google <>
help <> *
image <>
map <> *
stockticker <>
stock <> *
[tell] <>
[urban] <> *
weather <>
wiki <> *
youtube <>

Contributors to Raven

Contributors to original Limbo

Docker Pull Command
Source Repository