Open Charcoal-SE/SmokeDetector on Github

View project


Build Status Circle CI Coverage Status Open issues Open PRs

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 wiki.

Detailed documentation for setting up and running SmokeDetector is in the wiki.

Basic setup

To set up, please use

git clone
cd SmokeDetector
git config "[email protected]"
git config "SmokeDetector"
git checkout deploy
sudo pip3 install -r requirements.txt --upgrade
pip3 install --user -r user_requirements.txt --upgrade

Next, copy config.sample to a new file called config, and edit the values required.

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


SmokeDetector only supports Stack Exchange logins, and runs on Python 3.5 or higher, for now.


Licensed under either of

at your option.

Contribution Licensing

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.