Create an Account Already have an account? Sign In: Requester
We're Hiring! Learn More

Amazon Mechanical Turk Command Line Tools

The Amazon Mechanical Turk Command Line Tools are a set of command line interfaces allowing you to easily build solutions leveraging Amazon Mechanical Turk without writing a line of code.

Details

License: Amazon Software License

License Notice

Copyright 2008-2016 Amazon.com, Inc. or its affiliates, or a third party where indicated. All Rights Reserved. All of the code, software libraries, applications, updates, tools, and other information and materials made available for download from this web page ("Software") are licensed under the Amazon Software License (the "License"). You may not use the Software except in compliance with the License. A copy of the License is located at aws.amazon.com/asl or in the "license" file accompanying the Software. The Software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Get Started

  1. Sign up for an Amazon Web Services (AWS) account at the AWS web site.
  2. Sign up for an Amazon Mechanical Turk Requester account at the Requester web site.
  3. Download and install the latest version of the Java Runtime Environment (JRE) at the following website: http://www.oracle.com/technetwork/java/javase/downloads/index.html.
  4. Download and unzip the latest version of the Amazon Mechanical Turk Command Line Tools.
  5. Add your AWS access key and secret key to the mturk.properties file found in /bin directory.
  6. Set your JAVA_HOME environment variable to point to the location of your Java Run Time environment.
  7. You are ready to go! Please refer to the GettingStarted.html file in the Command Line Tool package for detailed instructions and examples of how to use the tool.

Supported Environments

The Command Line Tools can be run on the following environments:

  • Microsoft Windows (Download)
  • Unix based system (i.e. Mac OSX, Linux, etc.) (Download)

Features and Benefits

The Amazon Mechanical Turk Command Line Tools offers you the following features and benefits:

Feature Benefit
Bulk load HITs via a Question Template File, an Input File, and a HIT Properties File. No coding necessary. Only simple text file manipulation, using Microsoft Excel to manage your input and simple XML editing.
Retrieve submitted results as a file. Results can be easily viewed in a text editor or Excel and can be easily parsed for integration to your backend system or into another HIT workflow.
Bulk approve/reject assignments Results can be easily approved/rejected using files.
Change properties for HITs that are live Change properties (i.e. reward) for HITs that are already in production.
Manage your Workers Create and maintain your qualifications to manage your Workers. Prevent undesirable Workers from completing your HITs by using the Block Worker command.

Comments, Questions or Feedback

If you have any comments, questions, or feedback concerning the Amazon Mechanical Turk Command Line Tools, please visit the Amazon Mechanical Turk discussion forums.