First steps with gMission

gMission is a open source crowdsourcing platform. It is easy to use so that you can get started without learning the full complexities of the problem it solves.

In this tutorial you will learn the absolute bascis of using gMission. You will learn about;

• Installing docker.
• Installing gMission.
• Start gMission backend service.
• Run gMission client demo.

gMission may seem daunting at first - but don’t worry - this tutorial will get you started in no time. It is deliberately kept simple, so to not confuse you with advanced features. After you have finished this tutorial it’s a good idea to browse the rest of the documentation, for example the Next Steps tutorial, which will showcase gMission’s capabilities.

Installation

You can install gMission by following steps.

Installing docker

gMission’s backend service is built with Python and Flask, it is packed with docker for fast deployment. Before using gMission, please make sure your machine has Docker installed. If you already have Docker, please move to next step.

Please follow Docker Docs to install docker, if you are using OS X and Windows, please remember to install VirtualBox and Docker Machine.

In order to start gMission’s service, we also need to install Docker Compose.

Installing gMission

Once docker installed, we can get gMission backend source code from Github repo.

git clone https://github.com/gmission/gmission

Starting gMission

Then enter gmission/docker directory and start gMission with docker-compose command

cd gmission/docker
docker-compose up

if all services started with no error, you can check the status of gMission by curl gMission’s API, note that gMission will listen on port 9090.

curl http://localhost:9090/

if you get gMission running shown, it means you have your own gMission service started.

Run gMission client demo.

• python version

  git clone https://github.com/gmission/gmission_client_py_demo
  cd gmission_client_py_demo
  

  edit demo.py, change line #20 and fill your own gMission backend’s endpoint like

  client = GmissionClient('http://localhost:9090/')
  

  save and run it with python demo.py, the script will create a demo user, some sample campaign and HIT tasks with answers.

• Android version

• iOS version