Skip to content
curation workflow automation and coordination
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


PyPI version

curation workflow automation and coordination

  • find RRIDs in articles
  • look them up in the SciCrunch resolver
  • create Hypothesis annotations that anchor to the RRIDs and display lookup results

Getting Started

Capturing the bookmarklet

Visit https://HOST:PORT/bookmarklet and follow the instructions.

Using the bookmarklet

Visit an article that contains RRIDs, click the bookmarklet

Checking results in the browser

The found RRIDs are logged to the JavaScript console

Checking results on the server

The found RRIDs are logged to timestamped files, along with the text and html of the article that was scanned for RRIDs

Setup on Gentoo

As root.

layman -a tgbugs-overlay
emerge scibot
rc-config add scibot-bookmarklet default
vim /etc/conf.d/scibot-bookmarklet  # set username, group, api key, etc.
/etc/init.d/scibot-bookmarklet start

Setup on ubuntu 18.04

Set export PATH=~/.local/bin:${PATH} in ~/.bashrc

  1. sudo apt-get install build-essential python3-dev libxml2-dev libxslt1-dev
  2. sudo pip3 install --user pip pipenv
  3. git clone
  4. cd scibot && pipenv install
  5. pipenv shell to get an environment with acess to all the required libraries.
  6. Inside the pipenv shell (after following steps 6-10 below) you should be able to run commands like python scibot/

Setup on amazon

  1. ssh in to the host that will serve the script
  2. sudo yum install gcc libxml2 libxml2-devel libxslt libxslt-devel python36 python36-devel python36-pip
  3. sudo alternatives --set python /usr/bin/python3.6
  4. sudo pip install pipenv
  5. git clone
  6. cd scibot && python3.6 wheel && pipenv install dist/*.whl
  7. export SCIBOT_USERNAME=someusername
  8. export SCIBOT_GROUP=somegroupname
  9. unset HISTFILE
  10. export SCIBOT_API_TOKEN=sometoken
  11. export SCIBOT_SYNC=somerandomnumber (e.g. run head -c 100 /dev/urandom | tr -dc 'a-zA-Z0-9' every time)
  12. create a screen session
  13. in the screen session run pipenv run scibot-server you should create a link to the log files folder in ~/scibot/
  14. get letsencrypt certs using certbot, follow directions here (prefer standalone)
  15. alternately if using a cert from another registrar you may need to bundle your certs cat my-cert.crt existing-bundle.crt > (see for details)
  16. before or after starting gunicorn you need to run sudo yum install nginx && sudo cp ~/scibot/nginx.conf /etc/nginx/nginx.conf && sudo service start nginx
  17. run pipenv run scibot-sync in another screen (if run in a terminal with a different environment you need to run step 10 again first)

Development setup

To set up scibot for development (for example if you want to run manual releases) 0. Install python3 and pip for your os (e.g. on macos use brew)

  1. From your git folder run git clone
  2. pushd scibot
  3. pip3 install --user -e . will install requirements and register the scibot folder under version control with python as the scibot module.
  4. popd
  5. scibot currently makes use of my version of some of the core code which is not available as a package, to install it run the following
git clone
pushd h
git checkout flask-new-3
echo "export PYTHONPATH=$(pwd)/h:${PYTHONPATH}" >> ~/.bashrc
# may need to be ~/.bash_profile depending on your system
source ~/.bashrc

If all else fails

Make sure you have >=python3.6 and pip installed. Clone the repo and run python develop --user.

You can’t perform that action at this time.