Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gesteves/snarkov

A hilarious Sinatra-based Markov bot for Slack.
https://github.com/gesteves/snarkov

bot heroku markov-bot ruby sinatra slack

Last synced: 10 days ago
JSON representation

A hilarious Sinatra-based Markov bot for Slack.

Host: GitHub
URL: https://github.com/gesteves/snarkov
Owner: gesteves
Created: 2014-07-03T02:22:19.000Z (over 10 years ago)
Default Branch: main
Last Pushed: 2023-03-16T05:38:25.000Z (over 1 year ago)
Last Synced: 2024-02-15T07:32:32.206Z (9 months ago)
Topics: bot, heroku, markov-bot, ruby, sinatra, slack
Language: Ruby
Homepage:
Size: 157 KB
Stars: 26
Watchers: 2
Forks: 11
Open Issues: 6
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# snarkov

Snarkov is a Sinatra-based [Markov bot][mb] for [Slack][slack].

![](http://i.imgur.com/HJI9SLK.png)

[mb]: http://stackoverflow.com/questions/5306729/how-do-markov-chain-chatbots-work
[slack]: https://slack.com

## Installation

The simplest way to set up snarkov is using [Heroku][he]. Just press this button to deploy it:

[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)

You'll need to set up a Slack [outgoing webhook][ow] to send messages to snarkov. Set it up so it listens to a single channel of your choice, _don't_ set up a keyword. Copy the integration's token, you'll need it to deploy the app. You'll also need a Slack API token. You can get one by going to [this page][token] while logged into Slack. Once you have everything in place, deploy the app, then set the outgoing webhook's url to `https://[your-heroku-app].herokuapp.com/markov`, and save it.

[he]: http://www.heroku.com
[ow]: https://slack.com/services/new/outgoing-webhook
[token]: https://api.slack.com/web

## Importing channels

Snarkov works better if it has a lot of text to work with. To help populate it, you can feed it the entire history of a list of Slack channels. **Warning:** Depending on how many messages are in the channel's history, this might take a long time, and potentially fill up your free Heroku Redis account very quickly. You'll probably want to go to your Heroku dashboard and upgrade your Redis plan to one of the paid levels before doing this, or use the `DAYS` option to limit the amount of text you're importing.

To populate redis in production, install the [Heroku Toolbelt](https://toolbelt.heroku.com) and run:

```
$ heroku run rake ingest CHANNELS='#channel-name' --app your-heroku-app-name
```

The `ingest` task takes a single channel name, or a comma-separated list of channel names, e.g.:

```
$ heroku run rake ingest CHANNELS='#random,#general' --app your-heroku-app-name
```

If you want to import a channel's history going back only a certain number of days, you can add a `DAYS` option. For example:

```
$ heroku run rake ingest CHANNELS='#random,#general' DAYS=5 --app your-heroku-app-name
```

This will import the last 5 days of chat history from the #random and #general channels.

If you only want to import a certain user's messages, use the `USERNAME` option. For example:

```
$ heroku run rake ingest CHANNELS='#random,#general' USERNAME="guille" --app your-heroku-app-name
```

## Usage

After snarkov is up and running, the outgoing webhook you set up will send every message in the channel you selected (except those from other integrations) to snarkov, which will process and store it for future usage. It might respond with a Markov-generated message of its own, depending on the number you have set in the `RESPONSE_CHANCE` environment variable, with 0 meaning it will never respond, and 1 meaning it'll respond every single time.

If you have a Mac, a fun thing to do is run this in the terminal:

```
$ curl -s http://[your-heroku-app]/markov?token=[outgoing-webhook-token] | say -i
```

## Running locally

1. Install redis
2. Create a `.env` file and put the config variables there (see `.env.example`)
3. Run `bundle install`
4. Run `foreman start -f Procfile.dev`
5. Send POST requests to `http://localhost:5000/markov` to populate it, with the `text` parameter being the message's text, and `token` the outgoing webhook's token.
6. Send GET requests to `http://localhost:5000/markov?token=[OUTGOING_WEBHOOK_TOKEN]` to see a random reply

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

## License

BSD license

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.