okra

NOTE: This project is in alpha stage and under ongoing development. It may be subject to fundamental changes anytime.

Okra is a mobile (Android/iOS) app which allows its users to participate in psycholinguistic experiments. It receives the experiment setup and stimuli from a server of the institution conducting the experiment, presents the stimuli to the participant, collects responses and behavioral data, and sends them back to the server.

Supported tasks

The app currently provides implementations of various types of tasks related to psycholinguistics and reading comprehension in particular:

Issues and pull requests about adding more tasks are welcome (as long as they make sense).

Supported languages

The app is currently available in these localizations:

Pull requests adding more languages are welcome.

💻 Source code

🖼️ Screenshots

Documentation

Getting started

Conducting experiments

To create and conduct experiments, you need to:

  1. Set up a server that serves an API according to the specs. There is an example implementation.
  2. Create a participant ID and a registration key for each participant to authenticate them.
  3. Generate QR codes from strings like this:
    <base-url>\n<participant-id>\n<registration-key>
  4. Give the QR codes to your participants to scan.
  5. Distribute experiments and tasks using the API according to your own logic.

Developing

Requirements:

While developing, you can use the dummy server under dev_server/ and connect to it from the app on your emulator (http://10.0.2.2:<port> on Android) or device.

Running tests:

Code formatting / static analysis: