This is REDbot, the Resource Expert Droid.

REDbot checks HTTP resources for feature support and common protocol problems. You can use the public instance on <https://redbot.org/>, or you can install it locally and use it on the command line, or even self-host your own Web checker.

Your ideas, questions and other contributions are most welcome. See CONTRIBUTING.md for details.

REDbot needs:

1. Python 3.5 or greater; see <http://python.org/>
2. The Thor HTTP library; see <http://github.com/mnot/thor/>
3. The markdown library; see <https://pythonhosted.org/Markdown/>
4. To use REDbot on the Web, you'll need a Web server that implements the CGI interface; e.g., Apache.

Unpack the REDbot tarball. The relevant files are:

• bin/redbot_cgi.py - the Web CGI script for running REDbot
• bin/redbot_cli - the command-line interface
• redbot/ - REDbot's Python library files
• redbot/assets/ - REDbot's CSS stylesheet and JavaScript library

To install from source (e.g., if you clone from github):

python setup.py install

installs REDbot's libraries as well as the command-line version as 'redbot'.

To run REDbot as a CGI script, place redbot_cgi.py where you wish it to be served from by the Web server, and place config.txt in the same directory.

For example, with Apache you can put it in a directory and add these configuration directives (e.g., in .htaccess, if enabled):

AddHandler cgi-script .py
DirectoryIndex redbot_cgi.py

If the directory is the root directory for your server "example.com", this will configure REDbot to be at the URI "http://example.com/".

You can also locate config.txt somewhere else, and indicate its path in an environment variable:

SetEnv REDBOT_CONFIG /path/to/config.txt

The contents of the assets directory also need to be made available on the server; by default, they're in the 'static' subdirectory of the script's URI. This can be changed using the 'static_root' configuration variable in config.txt.

You should also create the directory referenced by the 'save_dir' configuration variable, and make sure that it's writable to the Web server process. This is where RED stores state files, and you should configure a cron job to regularly clean it. For example:

0 * * * * find /var/state/redbot/ -mmin +360 -exec rm {} \;

If you don't want to allow users to store responses, set save_dir to 'None'.

You can also build the project through docker, clone from Github then :

docker build -t redbot .

Start the webserver

docker run -p 8080:80 redbot

Use the command line

docker run --entrypoint=/redbot/bin/redbot redbot <url>

Icons by Momenticon. REDbot includes code from jQuery and prettify.js.