README

-- GETTING TAEB

The preferred method for obtaining the TAEB source is from the github repo:
    git clone git://github.com/sartak/TAEB.git

Alternatively, you can download "http://github.com/sartak/TAEB/tarball/master"
and extract to the directory of your choice.

You can also download TAEB from the CPAN: cpan -i TAEB

Downloading the tarball or installing from CPAN means less work up front (no
need to install git), but it'll be more work every time you want to update.


-- INSTALLING FROM TARBALL

If you're on Ubuntu, you'll first need to install the "build-essential" (for
make) and "libncurses5-dev" (for the Curses library) packages. If you are on OS
X, you will need Xcode and probably a few packages from MacPorts.


$ perl Makefile.PL

Answer the defaults to any dependencies it asks about. You may have to
set up CPAN. The defaults are usually fine. Be sure to set a mirror though.

$ make && sudo make install

This will install the modules from CPAN. TAEB's dependencies themselves
usually have a few dependencies. All in all you're probably looking at
about 60 modules.


-- AI

Though TAEB ships with a demo AI, you should still install a robust AI. The
most actively developed AI is Behavioral. The preferred method to get it is
still through git:
    git clone git://github.com/sartak/TAEB-AI-Behavioral.git

Or you can get a tarball from
"http://github.com/sartak/TAEB-AI-Behavioral/tarball/master" or the CPAN.


-- CONFIGURATION

TAEB itself has a lot of configuration. It sets up some sensible defaults for
you (such as playing nethack locally with the Demo AI and communicating with
you via Curses). You aren't required to set up config, but if you want to
change how TAEB operates, such as by making him play on a NetHack server, you
can. Specify configuration in ~/.taeb/config.yml, which is written in YAML
(http://en.wikipedia.org/wiki/Yaml). Read the sample configuration in
TAEB::Config for more details.

-- RUNNING TAEB

You should now be ready to run TAEB! Type "taeb" and cross your fingers.