Quick start

Follow these instructions to get started. If anything is unclear, send me an e-mail!

First Steps

TurkServer is being improved constantly and there are no versioned releases yet. To build your experiment, you'll check out the code directly from GitHub.

1. Set up your GitHub account so that Git works and to allow for cloning of repositories.
2. Download an Eclipse distribution. If you get the binary package for Java development, you'll get m2e (Maven support) and EGit (Git support) built in, which is all you need. If you don't have those plugins, install them using Eclipse's software manager.
3. Start Eclipse and create a workspace for your Turk experiments.

Setting up Code

1. Check out the libmao project into your workspace. This is a library containing some common code shared with projects other than TurkServer. In the future, we will remove this dependency.
2. Check out the TurkServer project into your workspace using Git (links are available from the code section on this site.)
3. Import both projects into Eclipse as existing Maven projects. (File > Import... > Maven > Existing Maven Projects). This will cause all the dependencies to download and the code to compile properly.
4. Things should compile without issue. If you have errors, it may be due to some extra libraries not being automatically added to your build path. You can add these manually in Eclipse (they are in turkserver/lib).
5. Design and code your experiments! We recommend writing test clients for your experiments and simulating them - it saves both time and effort because you don't want to run buggy experiments when using real money.