swiggityspeare

Character-based recurrent neural networks wrapped into an IRC chatbot. Initially designed to be colloquial English with a touch of Shakespeare, the network can't be open-sourced for privacy reasons: training data came from IRC users who didn't consent to open-sourcing.

tl;dr environment setup

Swiggityspeare now comes with an easy setup script to get started! You'll still need to install CUDA manually, but here's the process:

• install the CUDA Toolkit
• git clone https://github.com/raidancampbell/swiggityspeare.git --recursive
• cd swiggityspeare
• ./setup.sh
• java -jar swiggityspeare.jar -c "#swag #cwru" -n babbyspeare

setup.sh will ask to install Torch, init+update the git submodule for Andrej Karpathy's char-rnn, move the neural network into place, and install the required packages with luarocks.

dependencies

Swiggity's Java dependencies are all taken care of at compile time with the .jar files in the dependencies directory.

Other than CUDA, all of swiggity's system dependencies are best installed using setup.sh, as explained above. Otherwise, manually install Torch, git submodule init and git submodule update, and use luarocks (provided with Toch) to install cunn cutorch nngraph optim.

Test the environment with a quick th train.lua, whose default settings should begin training from a Shakespeare dataset included in the char-rnn repository.

It's build-your-own neural network. A sample network is in dependencies/irc_network.t7: it's a quick Shakespeare-trained network. This needs to be moved into the newly cloned char-rnn directory to work. setup.sh manages the initial copying for you.

At this point usage is pretty simple. The project is based on IntelliJ, so just build->build artifacts->swiggityspeare.jar, or use the prebuilt swiggityspeare.jar provided.

usage

Execution is a simple java -jar swiggityspeare.jar -n bot_nick. However, the jar expects the dependencies directory to be alongside it (or the configuration to be set), so that it knows where the char-rnn code is, and can execute it. The prepackaged .t7 neural network needs to be moved into the cloned char-rnn directory.

When in doubt, read one of the .prop files for options. A new one is generated for each bot nick.

Contributions

Git-workflow-style fork-commit-pullreqest. You kids are all better at git than I am, so I'm learning from you here.

License

MIT