botty-bot-bot-bot

KO | EN

gitlite — search

#python #ai #typescript #llm #golang #android #machine-learning #rust #deep-learning #linux #macos #windows #awesome #ios

botty-bot-bot-bot

(★ 10)

Personable chatbot for Slack using the Slack Realtime Messaging API.

botty-bot-bot-bot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Botty Bot Bot Bot
=================
Personable chatbot for [Slack](https://slack.com/) using the [Slack Realtime Messaging API](https://api.slack.com/rtm).

See the [code reference](https://github.com/Uberi/botty-bot-bot-bot/blob/master/docs/reference.md) for API documentation, project file layout, and more.

See the [plugin writing guide](https://github.com/Uberi/botty-bot-bot-bot/blob/master/docs/writing-plugins.md) for information about how to develop your own Botty plugins.

Features
--------

* **Debug mode with Botty Slack Simulation Environment**: interact with, test, and debug Botty and Botty plugins locally on the command line, without using Slack at all.
* In-process **Python REPL**: monitor, patch, or control running Botty instances **without restarting** or editing files.
* Excellent **Slack feature support**: supports reactions, threads/replies, message edits/deletions, and so on.
* Simple and reliable: Botty gracefully handles **plugin exceptions**, **network issues**, and more.
* Robust **plugin API**: friendly error messages and well-documented functions makes development fast and productive - each plugin is simply a Python class.
* Strong **Slack protocol compliance**: supports periodic ping, message escape sequences, and more, on top of the official Slack Python library.

Deployment
----------

### Bot and bot plugin configuration

Various plugin setup procedures:

* `events`: run `sudo src/plugins/events/generate_oauth_credentials.py`.
* `haiku`: run `sudo src/plugins/haiku/generate_haiku_lines.py`.
* `generate_text`: run `sudo src/plugins/generate_text/generate_chains_db.py`.
* `spaaace`: add Imgur API credentials to `src/plugins/spaaace/imgur_credentials.json`.
* `snek`: add the emoji from `src/plugins/snek/emoji/*.png` to Slack.

To run in production mode, run `python3 src/botty.py SLACK_API_TOKEN_GOES_HERE`, where `SLACK_API_TOKEN_GOES_HERE` is the Slack API token (obtainable from the [Slack API site](https://api.slack.com/)). Alternatively, edit `example-start-botty.sh` to replace `SLACK_API_TOKEN_GOES_HERE` with the Slack API token, then run `./example-start-botty.sh`.

Currently, a Botty instance is deployed for [nokappa.slack.com](https://nokappa.slack.com/) on EC2 inside a [tmux](https://tmux.github.io/) session, to allow monitoring and management over SSH.

### History server

From a fresh new t2.micro instance on AWS EC2 with a new 16GB EBS volume:

1. SSH into the machine: `ssh ec2-user@ec2-34-213-63-151.us-west-2.compute.amazonaws.com`.
2. Run software updates: `sudo yum update`.
3. Harden SSH: in `/etc/ssh/sshd_config`, change `Port` to `48372` (doesn't increase security, but reduces login spam) and `PasswordAuthentication` to `no` and `PermitRootLogin` to `no` and `AllowUsers` to `ec2-user`. Restart `sshd` using `sudo service sshd restart`. Stop unnecessary services: `sudo service sendmail stop`.
5. Get requirements: `sudo yum install git python35 python35-pip python35-devel nginx tmux htop curl libjpeg-devel freetype-devel`.
6. Get the code: `sudo mkdir -p /var/www && cd /var/www && sudo git clone https://github.com/Uberi/botty-bot-bot-bot.git && cd botty-bot-bot-bot`
7. If applicable, transfer over any existing Slack history into the `@history` folder (create `@history/` and `@history/files/` if they don't exist, both with permissions 755).
8. Set up an hourly cronjob with `sudo crontab -e` that updates history and merges with RTM chat data using `utils/download-history.py`, `utils/merge-channel-logs.py`, and `utils/export-history-to-db.py`.
9. Set up Gunicorn as an Upstart service (Amazon Linux uses Upstart as its init system): `sudo cp serve-history/botty-upstart.conf /etc/init/botty.conf`.
10. Fill in the missing values in `example-start-prod-serve-history.sh` (e.g., Slack OAuth client ID/secret, team ID, Flask sessions secret key).
11. Make log files writeable: `chmod a+w serve-history/log/*` (Gunicorn will be run as user `nobody`, so any files it writes must be world-writeable).
12. Set up Nginx as a reverse proxy: `sudo cp serve-history/botty-nginx.conf /etc/nginx/conf.d/botty.conf; chkconfig nginx on`. Edit the directory path in `/etc/nginx/conf.d/botty.conf` if your Botty project is not in `/var/www/botty-bot-bot-bot`.
13. Set up SSL with Let's Encrypt: `sudo wget https://dl.eff.org/certbot-auto && sudo chmod a+x certbot-auto && sudo ./certbot-auto --nginx --debug`, follow the prompts.
14. Set up twice-daily certificate renewal cronjob with Let's Encrypt: add `55 0,12 * * * PATH=/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/opt/aws/bin:/home/ec2-user/.local/bin:/home/ec2-user/bin:/opt/aws/bin:/home/ec2-user/.local/bin:/home/ec2-user/bin /var/www/botty-bot-bot-bot/certbot-auto renew --debug >> /var/www/botty-bot-bot-bot/letsencrypt-renew-certificate.log 2>&1` in the root crontab with `sudo crontab -e` (setting `PATH` is necessary in order to get Nginx config updates to work).
15. Start Gunicorn and Nginx: `sudo initctl restart botty` and `sudo service nginx restart`.
16. In the AWS EC2 Console, under Security Groups, configure the instance's security group's inbound rules to allow TCP connections on 80 (HTTP), 443 (HTTPS), and 48372 (our custom SSH port).
17. Login with `ssh -p 48372 ec2-user@ec2-34-213-63-151.us-west-2.compute.amazonaws.com -t 'tmux attach'`

Some sources: [ExploreFlask](http://exploreflask.com/en/latest/deployment.html), [Deploying Gunicorn](http://docs.gunicorn.org/en/stable/deploy.html), [Upstart Cookbook](http://upstart.ubuntu.com/cookbook/).

Developing Botty
----------------

See the "Deployment" section for information about setting up an environment suitable for developing Botty with.

To test locally, run `python3 src/botty.py` in the terminal:

$ ./src/botty.py
    No Slack API token specified in command line arguments; starting in local debug mode...

##########################################
    #   Botty Slack Simulation Environment   #
    ##########################################

This is a local chat containing only you and Botty. It's useful for testing and debugging.

The following slash commands are available:

/react -3 eggplant        | reacts to the third most recent text message with an eggplant
        /unreact 1 heart          | removes the heart reaction from the second earliest text message
        /reply -1 yeah definitely | replies to the most recent text message with "yeah definitely"
        /channel random           | moves you and Botty to the #random channel

#general    | Me: hello
    #general    | Me: calc integrate(1/x, x)
    #general    | Botty: integrate(1/x, x) :point_right: log(x)
    #general    | Me: /reply -1 threads work too :O
    #general    | Me (in thread for "integrate(1/x, x) :point_right: log(x)"): threads work too :O
    #general    | Me: where are the eggplants?
    #general    | Botty reacted to "where are the eggplants?" with :eggplant:
    #general    | Me: biggify hello
    #general    | Botty: ```
          ___           ___           ___       ___       ___     
         /\__\         /\  \         /\__\     /\__\     /\  \    
        /:/  /        /::\  \       /:/  /    /:/  /    /::\  \   
       /:/__/        /:/\:\  \     /:/  /    /:/  /    /:/\:\  \  
      /::\  \ ___   /::\~\:\  \   /:/  /    /:/  /    /:/  \:\  \ 
     /:/\:\  /\__\ /:/\:\ \:\__\ /:/__/    /:/__/    /:/__/ \:\__\
     \/__\:\/:/  / \:\~\:\ \/__/ \:\  \    \:\  \    \:\  \ /:/  /
          \::/  /   \:\ \:\__\    \:\  \    \:\  \    \:\  /:/  / 
          /:/  /     \:\ \/__/     \:\  \    \:\  \    \:\/:/  /  
         /:/  /       \:\__\        \:\__\    \:\__\    \::/  /   
         \/__/         \/__/         \/__/     \/__/     \/__/```
    #general    | Me:

Botty ships with several plugins by default, some of which require API keys or take some time to start. If you don't need those plugins, simply comment out the relevant lines in the body of the `initialize_plugins` function in `src/botty.py` to disable them.

License
-------

The source code is available online at [GitHub](https://github.com/Uberi/botty-bot-bot-bot).

This program is made available under the MIT license. See ``LICENSE.txt`` in the project's root directory for more information.

botty-bot-bot-bot

botty-bot-bot-bot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

botty-bot-bot-bot

botty-bot-bot-bot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README