Amazon Mechanical Turk is a useful thing. Interacting with it can be a giant pain.
But that's not what this post is about. I'd like to eventually use boto to build the control of AMT directly in to the webapp itself. For now, I'm using the command line interface that Amazon provides. The CLT is an ugly hack that implements the Java API in a bunch of shell scripts. I have written my own wrapper around their scripts that enforces a certain amount of sanity. You can get the scripts over on gitHub.
There isn't really any documentation beyond the scripts themselves. The idea is that you create an
amt-script directory where the new-and-improved scripts live. Under that directory, you create several
exp# directories that hold the info that you need for experiments. Even ones are for production runs. Odd ones are for sandbox runs. Once you get a sandbox run working you run
buildGoLiveExp.sh and it makes a copy from the staged experiment to a new go-live experiment. It's a bit of a hack at the moment, but it works for me. I like it because it gives me an audit trail for each thing I run on AMT. Feel free to use them yourself. (Or use them as inspiration for something better that you can write yourself!)