{"id":16894724,"url":"https://github.com/ddbourgin/mturk_utils","last_synced_at":"2026-05-14T21:02:55.228Z","repository":{"id":134549281,"uuid":"134108276","full_name":"ddbourgin/mturk_utils","owner":"ddbourgin","description":"Kludgey helper utils for running studies on Mechanical Turk","archived":false,"fork":false,"pushed_at":"2018-06-01T07:45:12.000Z","size":22,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-25T10:42:19.385Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddbourgin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-20T00:37:37.000Z","updated_at":"2024-04-23T20:24:03.000Z","dependencies_parsed_at":"2023-06-18T00:18:12.652Z","dependency_job_id":null,"html_url":"https://github.com/ddbourgin/mturk_utils","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddbourgin%2Fmturk_utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddbourgin%2Fmturk_utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddbourgin%2Fmturk_utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddbourgin%2Fmturk_utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddbourgin","download_url":"https://codeload.github.com/ddbourgin/mturk_utils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244591485,"owners_count":20477710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T17:19:42.851Z","updated_at":"2026-05-14T21:02:50.190Z","avatar_url":"https://github.com/ddbourgin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mturk utils\nConvenience scripts for interacting with MTurk/Psiturk. \n\nBefore using the scripts below, define the following environment variables:\n\n    \u003e export AWS_ACCESS_KEY_ID=\u003cyour MTurk access key id\u003e\n    \u003e export AWS_SECRET_ACCESS_KEY=\u003cyour MTurk secret access key\u003e\n\n\n## approve_batch.py\n**Usage:** `approve_batch.py [-h] [-t TITLE]`\n\nBatch HIT approver. Only approves HITs that are listed as reviewable,\nsaving a log of subject and HIT IDs that it approves to the current directory in an `.npz` archive. Can be run multiple times as more HITs are posted.\n\n#### Optional arguments\n  - `-h`, `--help`            show help message and exit\n  - `-t TITLE`, `--title TITLE` title of the experiment/HIT (default: None)\n  \n## assign_qualification.py\n**Usage:** `assign_qualification.py [-h] [--value VALUE] QUALIFICATION [WORKER [WORKER ...]]`\n\nAssign a qualification to a given worker ID/IDs. Useful for setting up\ninvitation-only makeup HITs.\n\n#### Positional arguments\n  - `QUALIFICATION`  qualification ID\n  - `WORKER`         worker ID (default: None)\n\n#### Optional arguments\n  - `-h`, `--help`     show help message and exit\n  - `--value VALUE`  qualification value (default: 1)\n  \n## create_qualification.py\n**Usage:** `create_qualification.py [-h] NAME DESCRIPTION`\n\nCreate a new worker qualification. Useful in preparation for making\ninvitation-only makeup HITs.\n\n#### Positional arguments\n  - `NAME`         name of the new qualification. used to represent the\n               qualification to workers\n  - `DESCRIPTION`  long description for the qualification. this is displayed when\n               a worker examines the qualification\n\n#### Optional arguments\n  - `-h`, `--help`   show help message and exit\n\n## psiturk_batcher.py\n**Usage:** `psiturk_batcher.py [-h] [-m MAX_ASSIGNMENTS] [-s SLEEP_TIME] n_assignments reward duration`\n\nEmulate TurkPrime's HyperBatch feature to avoid accruing an extra 20% MTurk fee\nfor having more than 9 subjects / HIT. Based on Dave Eargle's `psiturk_batcher.sh` script.\n\nNote: Before running this script, make sure that `launch_in_sandbox_mode =\nfalse` in the psiturk config.txt so that it creates live HITs!\n\n#### Usage\nPlace in the same directory as the experiment's `config.txt`.\n\n#### Positional arguments\n  - `n_assignments`         total number of assignments to post\n  - `reward`                reward (in USD) for completing a HIT\n  - `duration`              maximum amount of time (in hours) allowed to complete\n                        the HIT\n\n#### Optional arguments\n  - `-h`, `--help`            show help message and exit\n  - `-m MAX_ASSIGNMENTS`, `--max_assignments MAX_ASSIGNMENTS`\n                        maximum number of assignments for any individual HIT\n                        (default: 9)\n  - `-s SLEEP_TIME`, `--sleep_time SLEEP_TIME`\n                        time (in seconds) to sleep before posting a new batch\n                        (default: 5)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddbourgin%2Fmturk_utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddbourgin%2Fmturk_utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddbourgin%2Fmturk_utils/lists"}