zulip/templates/zerver/integrations/hubot.md

1. Follow the **Getting Started with Hubot** section of the
   [Hubot README](https://hubot.github.com/docs/#getting-started-with-hubot)
   to create your Hubot. You'll have a new directory from
   which `bin/hubot` starts a vanilla Hubot instance with
   the shell backend.

2. In your Hubot's directory, install the Zulip adapter. Run:
   `npm install --save hubot-zulip`

3. On your {{ settings_html|safe }}, create a bot account. Note
   its username, API key and full name; you will use them on the
   next step.

4. To run Hubot locally, first, set the following environment
   variables by running:

```
export HUBOT_ZULIP_SITE="{{ external_api_path_subdomain }}"
export HUBOT_ZULIP_BOT="hubot-bot@example.com"
export HUBOT_ZULIP_API_KEY="your_key"
```

Then, run:

`bin/hubot --adapter zulip --name "myhubot"`

The `--name` parameter must match the name you gave the bot on
the settings page.

Hubot will automatically listen for commands on all public streams.
You can also invite Hubot to invite-only streams.

To test your Hubot installation, send it an @-notification with a
basic command, for example `@Hubot pug me`, which should produce a
result like this:

![](/static/images/integrations/hubot/001.png)

[Source code for the hubot-zulip adapter is available on GitHub][1]
[1]: https://github.com/zulip/hubot-zulip

[Check out all integrations available via Hubot][2]
[2]: https://github.com/hubot-scripts