	
	sadface
		an IRC Markov Chain chatbot by Benjamin Keith

INTRO
Markov bots make for amusing text generators. They don’t make much sense, usually. When they do make sense, it’s pure chance.

sadface draws its vocabulary and concepts from a flat text file, where each line is considered a sentence. The bot chains words together to create sentences, which it passes to the IRC channel it is in.

Right now, sadface only supports one channel, but you can have multiple instances of sadface running with different configuration files. The configuration file is specified at runtime as an argument: python sadface-configgable.py config-file.ini

Included in sadface-bot.zip are sadface-configgable.py and default.ini. If you want to change default.ini, I encourage you to copy default.ini and change the variables, so you can have an untouched default.ini.

You can start sadface with a blank brain_file.txt, but its replies won’t make much sense at all until it’s heard a lot of conversation. I recommend putting several books into the file. Project Gutenberg (http://www.gutenberg.org/browse/scores/top) is a good place to start. Separate sentences by newlines. Replies look best if there are no quotes or tabs in brain_file.txt. You can specify different brain files with your config.ini.

INCLUDED
	sadface-configgable.py
		to run: python sadfac-configgable.py config.ini
		sadface also requires brain_file.txt, which is a flat txt file of newline-separated sentences. 
	default.ini
		the example configuration

MAKE ON YOUR OWN
	brain_file.txt
		a flat txt file of newline-separated sentences.
		sadface draws from brain_file to create its replies, and adds things said in-channel to its brain file. 
	

DEPENDENCIES
	Python 2.7.3
		available in repositories or at Python.org
		http://www.python.org/download/
	python-twisted
		available in the Ubuntu, Debian and openSUSE repositories
		source at http://twistedmatrix.com/trac/wiki/Downloads
		Windows and Mac installers at http://twistedmatrix.com/trac/wiki/Downloads

CREDITS
	Eric Florenzano
		sadface derives heavily from his MomBot Markov bot code
		http://eflorenzano.com/blog/2008/11/16/writing-markov-chain-irc-bot-twisted-and-python/
	hhokanson
		sadface's configuration methods derive from her AnonBot IRC anonymizer bot
		https://bitbucket.org/hhokanson/anonbot/src

