slack-machine 0.1

A sexy, simple, yet powerful and extendable Slack bot

Slack Machine is a sexy, simple, yet powerful and extendable Slack bot. More than just a bot, Slack Machine is a framework that helps you develop your Slack team into a ChatOps powerhouse.

Features

• Get started with mininal configuration

• Built on top of the Slack RTM API for smooth, real-time interactions

• Support for rich interactions using the Slack Web API

• High-level API for maximum convenience when building plugins

• Low-level API for maximum flexibility

• Plugin API features:

  • Listen and respond to any regular expression

  • Capture parts of messages to use as variables in your functions

  • Respond to messages in channels, groups and direct message conversations

  • Respond with Emoji

  • Respond in threads

  • Send DMs to any user

  • Support for message attachments

  • Listen and respond to any Slack event supported by the RTM API

Coming Soon

• Schedule actions and messages

• Plugin-accesible storage

• Help texts for Plugins

• … and much more

Installation

You can install Slack Machine using pip:

$ pip install slack-machine

It is strongly recommended that you install slack-machine inside a virtual environment!

Usage

1. Create a directory for your Slack bot: mkdir my-slack-bot && cd my-slack-bot

2. Add a local_settings.py file to your bot directory: touch local_settings.py

3. Create a Bot User for your Slack team: https://my.slack.com/services/new/bot (take note of your API token)

4. Add the Slack API token to your local_settings.py like this:

SLACK_API_TOKEN = 'xox-my-slack-token'

1. Start the bot with slack-machine

2. …

3. Profit!

Writing plugins

Coming Soon!