Read Me

This is the first prototype of a simple XMPP (aka Jabber) chat bot,
using the AIML interface to PandoraBots.

The official web site for this project is http://xmppchatbot.sourceforge.net/

Requirements:
This perl application is platform-independent, has no configuration file,
and requires only a perl interpreter and following free modules:
	AnyEvent
	AnyEvent::XMPP::IM::Connection
	Net::AIML
	String::CRC32

You may be able install the above modules by running the following command:
	cpan Net::AIML AnyEvent::XMPP::IM::Connection String::CRC32


Installation:
The daemon itself requires no installer or special privileges, just needs
to be executed as a user who has sufficient access to perform DNS lookups
and make network connections to www.pandorabots.com and to your preferred
XMPP service.

You may need to edit the first line of the script to set the location of
your perl interpreter.  You may also choose to hardcode the account
credentials (Jabber ID and password) in the script rather than passing
them on the command line.  See start-chatbot.sh for a sample startup script.


Customization:
The script has a default AI personality, you can customize the AI and
script by registering your own bot at PandoraBots and changing the
PANDORABOT variable in the script.  To register, and create a chat script,
visit http://pandorabots.com/ and click "Account Sign-up".


Feedback:
Please use SourceForge to report any bugs or suggest enhancements via
the services at http://xmppchatbot.sourceforge.net/


Sincerely,

Kevin Kadow
kevin_kadow@users.sourceforge.net