Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 2.15 KB

README.md

File metadata and controls

50 lines (33 loc) · 2.15 KB

SmokeDetector

Build Status Circle CI

Headless chatbot that detects spam and posts it to chatrooms. Uses ChatExchange, takes questions from the Stack Exchange realtime tab, and accesses answers via the Stack Exchange API.

Example chat post:

Example chat post

User documentation is in the GitHub wiki.

To set up, use

git clone https://github.com/Charcoal-SE/SmokeDetector.git
cd SmokeDetector
git submodule init
git submodule update
sudo pip install pip --upgrade
sudo pip install beautifulsoup4
sudo pip install requests --upgrade
sudo pip install websocket-client --upgrade
sudo pip install phonenumbers
sudo pip install regex
sudo pip install termcolor

To run, use nocrash.sh (preferably in a daemon-able mode, like a screen session.) You can also use python ws.py, but then SmokeDetector will be shut down after 6 hours; when running from nocrash.sh, it will be restarted. (This is to be sure that closed websockets, if any, are reopened)

You can run . ChatExchange/setp.sh to set local environment variables so that you don't have to log in every time.

SmokeDetector only supports Stack Exchange OpenIDs for now.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions