Talon_Bot is intended to be an extendable, hackable bot for Twitch chat.
-
Easily extensible via plugins, a.k.a. "units"
-
Responds to commands, or other chat-driven triggers
-
Allows creating new simple commands directly from Twitch chat.
-
Creates timestamped logs of chats
-
Interactive help system
-
A Twitch account, and an associated OAuth token as described in https://dev.twitch.tv/docs/irc/guide
-
Perl, minimum v5.20. This could be lowered with little effort if needed, but for simplicity a non-ancient version is assumed.
-
A POSIX environment to run in - Talon_Bot has only been tested on Linux, though it should presumably run well in other similar environments.
-
Clone the repository with
git clone https://github.com/edwinsage/Talon_Bot, or download and extract one of the releases. -
Change to the Talon_Bot directory and run
./Talon_Botto create a default config file,Talon_Bot.conf. -
Edit the created config file, particularly the lines for
userandauth. (Not needed to run in test mode) -
Run the bot. It will connect to the Twitch chat of the username (or other channel specified in the config), and will respond to commands. Alternatively, run the bot in test mode using
./Talon_Bot -t, which will skip the connection process and allow interaction directly on the command line.
Code is still in alpha and a bit of a mess. However, there is a fledgling plugin API for adding commands that lets you avoid all knowledge of the Talon_Bot code, except for a few variables. Check out docs/Unit_API.md for details.
Note that Talon_Bot is released under the AGPL, meaning that if you host the bot for other people to use, you must make sure that the links to the source code given by the !help command remain intact. In particular, this means IF YOU MAKE CHANGES TO THE SOFTWARE, YOU MUST HOST THE CODE SOMEWHERE AND UPDATE THE LINKS TO POINT TO IT. This could be as simple as cloning the repo on Github and pushing your changes there.