jabbot /

Filename Size Date modified Message
42 B
1.1 KB
4.4 KB
282 B
1.1 KB



Jabbot is a Ruby micro-framework for creating Jabber/MUC bots, heavily inspired by Sinatra and Twibot.

I modified the code of Twibot to fit my needs. The original Twibot code is located at:

A big thank you to Christian Johansen, who wrote the code for Twibot. Jabbot is heavily based on his code.

If your curious if this code is stable enough: I have a bot instance running on my server for quite some time now and it works great :)


Simple example

# Receive messages, and post them publicly
message do |message, params|
  post message.text

# Respond to query if they come from the right crowd
# query "message" => "user" is just some syntax sugar
# query "message", "user" will work, too
query :from => [:cjno, :irbno] do |message, params|
  post "#{message.user} I agree" => message.user

# Log every single line
# (you can use "message :all" too ;)
message do |message, params|

Running the bot

To run the bot, simply do:

ruby bot.rb

Jabbot uses the at_exit hook to start.


Deprecated: The option to configure by YAML files will be removed in the next stable release.

Jabbot looks for a configuration file in ./config/bot.yml. It should contain atleast:

login: jabber_login
password: jabber_password
channel: channel_to_join
server: server_to_connect_to
nick: mybot

You can also configure with Ruby:

configure do |conf|
  conf.login = "my_account"
  conf.nick = "mybot"

If you don't specify login and/or password in any of these ways, Jabbot will fail Nick is automatically set to "jabbot" unless something different is defined If you want you can set the XMPP Resource:

configure do |conf|
  conf.resource ="mybot_resource"

Default is "jabbot".


Like Sinatra, and other web app frameworks, Jabbot supports "routes": patterns to match incoming messages:

message "time :country :city" do |message, params|
  time = MyTimeService.lookup(params[:country], params[:city])
  post "Time is #{time} in #{params[:city]}, #{params[:country]}"

You can have several "message" blocks (or "join", "leave", "query" or "subject"). Every matching block will be called.

Jabbot also supports regular expressions as routes:

message /^time ([^\s]*) ([^\s]*)/ do |message, params|
  # params is an array of matches when using regexp routes
  time = MyTimeService.lookup(params[0], params[1])
  post "Time is #{time} in #{params[:city]}, #{params[:country]}"

If all you need is exact word matching you can say so:

message :exact => "pattern" do |message, params|

Internally this pattern is translated to /\Apattern\Z/, so you can use regex literals.


xmpp4r. You'll need atleast 0.4. You can get it via rubygems:

gem install xmpp4r

or get it from:


Jabbot is available via gem:

gem install jabbot

Is it Ruby 1.9?

All tests passes on Ruby 1.9. Seems like it works :)


There are two examples in the [samples][] directory:

  • jabbot_example.rb is a working sample without real functionality.
  • black.rb is the code I use for my own bot (without the config of course).



The code is released under the MIT license. See LICENSE.


If you'd like to hack on jabbot, start by forking my repo on GitHub:

jabbot needs xmpp4r, so just install it:

gem install xmpp4r


  1. Clone down your fork
  2. Create a thoughtfully named topic branch to contain your change
  3. Hack away
  4. Add tests and make sure everything still passes by running rake
  5. If you are adding new functionality, document it in the README
  6. Do not change the version number, I will do that on my end
  7. If necessary, rebase your commits into logical chunks, without errors
  8. Push the branch up to GitHub
  9. Send me (badboy) a pull request for your branch