Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
the Tactical Amulet Extraction Bot (for NetHack)
branch: master

This branch is 828 commits ahead of DrSunglasses:master

Convert a few messages to announcements

Many messages still remain to be converted.
latest commit efbc879bd0
Sean Kelly seankelly authored

Getting TAEB

The preferred method for obtaining the TAEB source is from the GitHub repo:

git clone git://

Alternatively, you can download a snapshot of the code as a tarball:

You could also download a potentially very old copy of TAEB from CPAN:

cpanm 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. We very strongly recommend using git.

Installing dependencies

TAEB uses Dist::Zilla for its packaging and toolchain support.

You can install TAEB's dependencies with the following commands:

dzil authordeps --missing | cpanm
dzil listdeps --missing | cpanm


Though TAEB ships with a demo AI, you should still install a robust AI. There are currently three AIs: Behavioral, Planar, and Magus.

Behavioral AI

The primary AI is Behavioral, since it is the original TAEB AI and is developed by many of the primary TAEB authors. The preferred method to get it is through git:

git clone git://

Or you can get a tarball from:

or an old copy from CPAN:

cpanm TAEB::AI::Behavioral

Planar AI

Another AI is Planar, whose design principle is "be the opposite of Behavorial". You can get it with darcs:

darcs get

Or the GitHub mirror:

git clone git://

Or a tarball snapshot of the GitHub mirror:

Magus AI

The newest AI is Magus, which optimizes specifically for Wizards. You can grab it from GitHub:

git clone git://


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 a config, but if you want to change how TAEB operates, such as by making him play on a NetHack server, you can. Specify the configuration in ~/.taeb/config.yml, which is written in YAML. The full list of configuration options, including the required .nethackrc file is provided in TAEB::Config. Sample configuration files are available in etc/examples.

Running TAEB

You should now be ready to run TAEB! If you're in the TAEB checkout, run perl -Ilib bin/taeb. Or, if you installed TAEB, run taeb. Either way, be sure to cross your fingers.

If perl doesn't find the installed modules you may need to set the $PERL5LIB environment variable to where you placed them.

Debug commands

TAEB ships with a number of debug commands. Typing ? will list them for you.

Hacking on TAEB

If you're sufficiently inspired by TAEB, we'd love to have you onboard! The best first step is to read TAEB::AI::Demo's code, then try some of the exercises. The exercises are geared toward letting you explore TAEB's codebase. Very tricky, we are.

We also write a lot about TAEB's architecture and dealing with programmatic NetHack on our blog,

Something went wrong with that request. Please try again.