/probot

a trainable robot that responds to activity on GitHub

Primary LanguageJavaScriptISC LicenseISC

PRobot

Join the chat at https://gitter.im/bkeepers/PRobot

Heads up! "PRobot" is a codename that is almost guaranteed to change.

PRobot is a trainable robot that responds to activity on GitHub. It's like Hubot, but for GitHub events instead of chat messages.

Installing

Heads up! The demo integration is for demo purposes only. It is very likely to go away at some point, so please don't use it for production purposes.

  1. Go to the demo integration, click Install, and then select an organization.

  2. Create a .probot.js file in your repository with the following contents. See Configuration for more information on what behaviors can be built.

     on('issues.opened').comment(`
       Hello @{{ sender.login }}. Thanks for inviting me to your project.
       Read more about [all the things I can help you with][config]. I can't
       wait to get started!
    
       [config]: https://github.com/bkeepers/PRobot/blob/master/docs/configuration.md
     `);
    
     include("bkeepers/probot:docs/demo.js");
    
  3. Open a new issue. @probot should post a comment (you may need to refresh to see it).

Deploy your own bot to Heroku

  1. Deploy - Click this button and pick an App Name that Heroku is happy with, like your-name-probot. Before you can complete this, you'll need config variables from the next step.
  2. In another tab, create an integration on GitHub, using https://your-app-name.herokuapp.com/ as the Homepage URL, Callback URL, and Webhook URL. The permissions and events that your bot needs access to will depend on what you use it for.
  3. After creating your GitHub integration, go back to the Heroku tab and fill in the configuration variables with the values for the GitHub Integration
  4. Create a .probot.yml file in your repository. See Configuring.