Metadata-Version: 2.0
Name: 100bot
Version: 1.0.1
Summary: Spice up your Slack-life with emojis!
Home-page: https://github.com/PeppyHare/100bot
Author: Evan Bluhm
Author-email: bluhme3@gmail.com
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/PeppyHare/100bot/issues
Project-URL: Source, https://github.com/PeppyHare/100bot/
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Chat
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Dist: slackclient
Requires-Dist: requests

# 100Bot

This is a son-of-[IoBot](https://github.com/adahn6/Io) project, taking the best
things about Io and turning them into a monster.

A picture is worth 1000 words:

![Screenshot of example conversation](example.png)

100Bot is powered by the Watson Tone Analyzer service. Each message is carefully
parsed for emotional significance and response, so that the perfectly
appropriate reaction emoji can be chosen.

## Running 100Bot

The bot requires three very specific parameters:
 - A Watson Tone Analyzer `username` credential
 - A Watson Tone Analyzer `password` credential
 - A Slack Integration Token for a bot

### Running with docker-compose

The easiest way to get 100bot up and running with dependencies is by using the docker service file included: `docker-compose.yml`. Modify the supplied `.env-sample` to provide credentials for the Watson Tone Analyzer and a Slack bot. Then build and start the service with:

```shell
docker-compose up -d
```


### Running natively with python

Pip modules `slackclient` and `requests` must be installed. Use virtualenv to make your life easier. Passing of credentials can be done with argparse:

```shell
python3 100bot.py \
 --bx-username "user" \
 --bx-password "verysecret" \
 --slack-token "xoob-137138657231-2ReKEpxlvWwe6vDBripOs7sR"

```

but can also be done with environment variables:

```shell
export BLUEMIX_USERNAME=user
export BLUEMIX_PASSWORD=verysecret
export SLACK_TOKEN="xoob-137138657231-2ReKEpxlvWwe6vDBripOs7sR"
python3 100bot.py

```

(yes, these are all fake credentials don't try them...)

