A standup bot for Slack
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.env.example
.gitignore
Dockerfile
Procfile
README.md
docker-compose.yml
morgenbot.py
requirements.txt
screenshot.png
wsgi.py

README.md

Morgenbot

Good morning! Morgenbot is a Slack standup bot. ☕

screenshot

Installation

  1. Clone the repo

  2. pip install -r requirements.txt

  3. Host the web app on Heroku:

    heroku create
    git push heroku master
    heroku ps:scale web=1
    heroku logs
    
  4. Set up some config variables using heroku config:set VARIBLE=value:

    • TOKEN: your team's Slack API token. (required)
    • USERNAME: your bot's username. (optional; defaults to 'morgenbot')
    • ICON_EMOJI: the emoji used in the bot's icon. (optional; defaults to ':coffee:')
    • CHANNEL: the channel in which you stand up. (optional; defaults to '#standup')
    • IGNORE_USERS: a string representing a comma-separated array of strings representing active channel users who never stand up. (eg '["username1", "username2"]'; optional; defaults to '')
    • INIT_GREETING: the way Morgenbot greets you when a standup is initialized. (optional; defaults to 'Good morning')
    • START_MESSAGE: the instructions Morgenbot issues when a standup starts. (optional; defaults to 'What did you work on yesterday? What are you working on today? What, if any, are your blockers?')
    • GIPHY: a string representing a boolean of whether you want to use Giphy on queries Morgenbot doesn't understand. (optional; defaults to FALSE)
  5. Add the URL where the web app is deployed as an outgoing webhook in Slack. Don't forget the trailing /!

  6. Type !standup in your chosen channel to start a new standup. (Need help? Type !help.)

Alternate Installation (Docker)

  1. Clone the repo
  2. Install the latest version of Docker Toolbox for local development and testing
  3. Run docker-compose up to build the container
  4. Environment variables can be set via the .env file (a sample .env.example file is included)

The container itself can be deployed to any Docker compatible host.

Thanks

This project takes its inspiration from tender, a standup bot for IRC; leaned heavily on Slask for its implementation of Flask; and uses the Slack API via the Python wrapper Slacker. Thank you.

Contributors

  • @eelzon
  • @sos4nt
  • @frodopwns
  • @alexbain