Lita uses regular RubyGems as plugins. You'll need at least one "adapter" gem to connect to the chat service of your choice. Add as many "handler" gems as you want to add functionality to your bot.
- Install the lita gem.
$ gem install lita
- Create a new Lita project.
$ lita new
This will create a new directory called lita with a Gemfile and Lita configuration file.
- Edit the Gemfile, uncommenting or adding the plugins you want to use. There should be an adapter gem (such as lita-hipchat or lita-irc) and as many handler gems as you'd like. For example:
source "https://rubygems.org" gem "lita" gem "lita-hipchat" gem "lita-karma" gem "lita-google-images"
Install all the gems you specified in the Gemfile:
$ bundle install
Install Redis. On OS X, you can use Homebrew with
brew install redis.
Test Lita out right in your terminal with the built-in shell adapter.
$ bundle exec lita
Type "Lita: help" to get a list of commands available to you.
Edit the Lita configuration file to add connection information for the chat service you're using. For example, if you're using the HipChat adapter, it might look something like this:
Lita.configure do |config| config.robot.name = "Lita Bot" config.robot.adapter = :hipchat config.adapter.jid = "email@example.com" config.adapter.password = "secret" config.adapter.rooms = :all end
You'll want to consult the documentation for whichever adapter you're using for all the configuration options. If you're going to deploy Lita to Heroku, you'll want to add the Redis To Go add on and set
config.redis.url = ENV["REDISTOGO_URL"].
Deploy your Lita project anywhere you like. If you're deploying to Heroku, you can use a Procfile like this:
web: bundle exec lita
Lita also has built-in support for daemonization if you want to deploy it to your own server.
Be sure to visit the Lita home page for lots more information on usage, configuration, and adding your own behavior to your robot!