Ralph is the LevelUp Platform team's beloved Zulip chat bot. He's a version of GitHub's Hubot.
In order to run Ralph locally, you'll need:
- Node.js 6.11 or newer
- PostgreSQL 12 or newer
First, create a Postgres database and tell Ralph how to connect to it.
createdb ralph_development
echo 'export DATABASE_URL=postgres://localhost/ralph_development' > .envRun Ralph locally using bin/hubot. You'll see some startup output and a prompt.
$ bin/hubot
[Sun, 04 Dec 2011 18:41:11 GMT] INFO Loading adapter shell
Hubot>
Then you can interact with Ralph by typing hubot help.
Hubot> hubot help
Hubot> animate me <query> - The same thing as `image me`, except adds a few
convert me <expression> to <units> - Convert expression to given units.
help - Displays all of the help commands that Hubot knows about.
...
Ralph is deployed on Heroku through the lu-ralph Heroku pipeline, which contains staging and production apps:
Pushing to the main branch of thelevelup/hubot-ralph will automatically trigger a deployment to staging. You can test your changes by addressing Ralph Staging in the Zulip #test stream:
Ross: ralph staging ping
Ralph Staging: PONG
When you've verified your changes using Ralph Staging, promote them to production.
heroku pipelines:promote --app lu-stg-ralph-rw-vaWhile it is tempting, try to avoid deploying Ralph to other LevelUp services' staging environments.
MIT