An annotation interface for detailed text annotation by crowdworkers along researcher-defined topics of interest. Under development for the Deciding Force Project. Currently, this app only runs locally.
The app is run by Docker. If you do not have it already, you will need to install it.
- For OS X El Capitan 10.11 and later, get Docker for Mac.
- For earlier OS X, get Docker Toolbox for Mac.
- For Windows 10 Pro, with Enterprise and Education (1511 November update, Build 10586 or later), get Docker for Windows.
- For Windows 7, 8.1 or other 10, get Docker Toolbox for Windows.
- For Ubuntu and other Linux distributions, install
To avoid having to use sudo when you use the docker command,
create a Unix group called docker and add users to it:
sudo groupadd docker
sudo usermod -aG docker $USER
Once installed, start the Docker application (if on a Mac), then go to the project directory and run:
docker-compose pull- To check for updated images
docker-compose up- After about 10 seconds this window stops scrolling info, usually ending with
LOG: autovacuum launcher started LOG: database system is ready to accept connections
Now TextThresher is running. Don't wait for a command prompt! Ctrl-C in this window will stop TextThresher.
./init_docker.sh# Inits Pybossa and loads all TextThresher sample data
./init_pybossa.sh# Just init Pybossa
and one of:
./init_django.sh# two test users and two empty projects for TextThresher
./init_thresher.sh# test users, two empty projects, sample articles without highlights
./init_thresher.sh --with-annotations# test users, two empty projects, sample articles with highlights
After initializing, Docker Toolbox users must enter:
./ssh_tunnel.sh# to enable using
yesto continue connecting. The VM password is
Now you can go to:
After a while, you may want to reclaim the Gigs of space that Docker is using for old images.
docker image prune# Get rid of outdated images. Leave containers alone.
docker system prune# More aggressive clean, will get rid of stopped containers including data in Pybossa and TextThresher databases. May end up re-downloading current images. Run this with containers up and running to avoid over-pruning.
You will need to create a new account in Pybossa. A default admin 'nick' is set up for TextThresher.
docker-compose stop to stop the containers.
exit in each terminal window. (Some may need more than one
exit to unwind.)
docker-compose down to both stop and remove the containers. THIS DISCARDS THE TEXTTHRESHER and PYBOSSA DATABASES!
Docker Toolbox notes
To stop the virtual machine providing Docker Toolbox services:
docker-machine stop default
So next time you want to run Docker you may need to:
docker-machine start default