{{:jabberlogo.png|}}

===== Goals =====

The goal of this project is to build an interactive Jabber/XMPP bot that can interpret commands and perform associated actions.

===== Source Code =====

Source code is available via a mercurial repository.  Please note that if the machine you wish to clone to is outside the university network you will have to [[http://www.compsoc.nuigalway.ie/wiki/how_to:ssh_tunneling|tunnel into riviera]] first.  Pushing is only allowed by project members. Please contact us if you would like to become part of this project.

<cli>$hg clone http://www.compsoc.nuigalway.ie/mercurial/jabber_bot</cli>
===== Progress =====
 * 24/11/08 - PHP Jabber Bot - Edgar. Discovered this little bot on my travels. Sadly he's in Spanish! I'm gonna work on a translation. He was originally designed to show members' jabber status on the Psi Forums. Perhaps could be implemented here! For the moment I'll link the original spanish version. To install, follow the README and the INSTALL instructions. (Requires class.jabber.php) http://frink.nuigalway.ie/~foehammer/edgar-jabberes.tar.bz2

(Found it here: http://jabberforum.org/showthread.php?t=322)

 * 26/6/08 - Modified example script - bot.rb - accordingly. Getting Error = /SFTP/bot.rb:95:in `initialize': wrong number of arguments (1 for 0) (ArgumentError)


 * 26/6/08 7:21pm - Switched to alternate Ruby Jabber Bot. Conveniently entitled 'rjbot'! Currently testing with jabber.org user ID's. Quite happily receives and parses commands from my gMail account. CPU footprint is quite low. 0.4% CPU time and 9MB memory allocation. Commands at the moment are limited to the following:

 Help: I understand the following commands:

         help [<command>]
         ? [<command>]
         Display help for the given command, or all commands if no command is specified

         puts <string>
         p <string>
         Write something to $stdout

         rand
         Produce a random number from 0 to 10

         remind <string>
         Remind me about something in 10seconds

This bot, like the others doesn't support SSL/TLS so secured connections are a no-no at the moment!

Next I'll be looking into getting it to open files locally on the server upon which it is being run. This could always be adapted to running scripts etc.


===== Project Forum =====

Please ask questions by using the forum.

 * [[http://www.sin.nuigalway.ie/boards/viewtopic.php?f=6&t=18467&sid=d2721505860ceb53b0c25cf345d985be&p=517115#p517115| Jabber Bot Forum]]

===== Project Members =====
  * [[http://www.compsoc.nuigalway.ie/~foehammer|John Long]]  <foehammer@compsoc.nuigalway.ie>

  * [[http://www.compsoc.nuigalway.ie/~andrewjregan|Andrew Regan]] <andrewjregan@compsoc.nuigalway.ie>
===== Resources =====
  * [[https://launchpad.net/rjbot|rjbot -- Current Ruby Jabber Bot library.]]
  * [[http://www.deepdarc.com/2005/06/12/jabber-bots/|Example of what can be done with Jabber Bots!]]
  * [[http://www.labnol.org/internet/tutorial-create-bot-for-gtalk-yahoo-messenger/4354/|Bot Tutorial with PHP]]