Getting Started With Hubot

You will need node.js and npm. Once those are installed, we can install the hubot generator:

% npm install -g yo generator-hubot This will give us the hubot yeoman generator. Now we can make a new directory, and generate a new instance of hubot in it. For example, if we wanted to make a bot called myhubot:

% mkdir myhubot % cd myhubot % yo hubot At this point, you’ll be asked a few questions about who is creating the bot, and which adapter you’ll be using. Adapters are hubot’s way of integrating with different chat providers.

If you are using git, the generated directory includes a .gitignore, so you can initialize and add everything:

% git init % git add . % git commit -m "Initial commit" If you’d prefer to automate your hubot build without being interactively prompted for its configuration, you can add the following options to the yo hubot command to do so:

Option Description --owner="Bot Wrangler [email protected]" Bot owner, e.g. “Bot Wrangler [email protected]” --name="Hubot" Bot name, e.g. “Hubot” --description="Delightfully aware robutt" Bot description, e.g. “Delightfully aware robutt” --adapter=campfire Bot adapter, e.g. “campfire” --defaults Declare all defaults are set and no prompting required You now have your own functional hubot! There’s a bin/hubot command for convenience, to handle installing npm dependencies, loading scripts, and then launching your hubot.

Hubot needs Redis to persist data, so before you can start hubot on your own computer, you should have Redis installed on your localhost. If just want to test Hubot without Redis, then you can remove hubot-redis-brain from external-scripts.json.

% bin/hubot Hubot> This starts hubot using the shell adapter, which is mostly useful for development. Make note of Hubot>; this is the name your hubot will respond to with commands. For example, to list available commands:

% bin/hubot hubot> hubot help hubot adapter - Reply with the adapter hubot animate me - The same thing as image me, except adds a few parameters to try to return an animated GIF instead. hubot echo - Reply back with hubot help - Displays all of the help commands that hubot knows about. hubot help - Displays all help commands that match . hubot image me - The Original. Queries Google Images for and returns a random top result. hubot map me - Returns a map view of the area returned by query. hubot mustache me - Searches Google Images for the specified query and mustaches it. hubot mustache me - Adds a mustache to the specified URL. hubot ping - Reply with pong hubot pronounce in - Provides pronunciation of ( is optional) hubot pug bomb N - get N pugs hubot pug me - Receive a pug hubot the rules - Make sure hubot still knows the rules. hubot time - Reply with current time hubot translate me - Searches for a translation for the and then prints that bad boy out. hubot translate me from into - Translates from into . Both and are optional hubot youtube me - Searches YouTube for the query and returns the video embed link. ship it - Display a motivation squirrel You almost definitely will want to change your hubot’s name to add character. bin/hubot takes a --name:

% bin/hubot --name myhubot myhubot> Your hubot will now respond as myhubot. This is case-insensitive, and can be prefixed with @ or suffixed with :. These are equivalent:

MYHUBOT help myhubot help @myhubot help myhubot: help Scripts

Hubot’s power comes through scripts. There are hundreds of scripts written and maintained by the community. Find them by searching the NPM registry for hubot-scripts . For example:

$ npm search hubot-scripts github NAME DESCRIPTION hubot-deployer Giving Hubot the ability to deploy GitHub repos to PaaS providers hubot hubot-scripts hubot-gith hubot-gh-release-pr A hubot script to create GitHub's PR for release hubot-github Giving Hubot the ability to be a vital member of your github organization … To use a script from an NPM package:

Run npm install --save to add the package as a dependency and install it. Add the package to external-scripts.json. Run npm home to open a browser window for the homepage of the script, where you can find more information about configuring and installing the script. You can also put your own scripts under the scripts/ directory. All scripts placed there are automatically loaded and ready to use with your hubot. Read more about customizing hubot by writing your own scripts.

use example file to run index.html,css in eclipse

and run with proxy server as http://localhost:8080 // issuse check same port is running already