Skip to content
/ raven Public
forked from llimllib/limbo

A simple, clean, easy to modify Slack chatbot (used to be called slask)

License

Notifications You must be signed in to change notification settings

fitsnips/raven

 
 

Repository files navigation

Project Raven (built on Limbo)

Based on the limbo slack client here: https://github.com/llimllib/limbo

A Slack chatbot

Installation

  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 install.dev && invoke serve.dev 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 install.dev to install raven in development mode * invoke serve.dev 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

kitten mittens

kitten mittens

Commands

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 string.

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

About

A simple, clean, easy to modify Slack chatbot (used to be called slask)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%