Fork me on GitHub

The first Ruby application framework for writing automated XMPP clients that support Messaging, Ad-Hoc Commands and Publish Subscribe Events. Out of the box you get authentication, authorization, contacts and management statistics.

Writing applications is easy.

Install

  gem install agent_xmpp

Configure

  # agent_xmpp.yml
  jid: myapp@nowhere.com
  password: secret
  roster:
      -
          jid:you@home.com
          groups: [admin]

  publish:
      - 
          node: time
          title: "Curent Time"

Code

  # myapp.rb
  require 'rubygems'
  require 'agent_xmpp'

  command 'hello' do
    'Hello World'
  end 
  
  discovered_pubsub_node do |serv, node|
    EventMachine::PeriodicTimer.new(60) do
      publish_time(Time.now.to_s)
    end  
  end

Run

  ruby myapp.rb

Documentation

Clients

The XMPP protocols supported by AgentXMPP are not supported by all clients. The following clients have been tested and provide full support.

Videos

Supported XEPs