edx-ora2 (Open Response Assessment)

7.0.0 verified Fri May 01 auth: no python

edx-ora2 is the Open edX plugin for Open Response Assessment (ORA) problems. It provides peer, self, and AI grading workflows in edx-platform. Current version: 7.0.0. Release cadence: irregular, major releases roughly annually.

pip install ora2

Common errors

error ModuleNotFoundError: No module named 'ora2' ↓

cause ora2 not installed or not in PYTHONPATH.

fix

Run pip install ora2 in the correct Python environment.

error django.core.exceptions.ImproperlyConfigured: Application labels aren't unique, duplicates: ora2 ↓

cause Two versions of ora2 installed or a conflicting module with same app label.

fix

Uninstall all versions (pip uninstall ora2) and reinstall the correct version.

error KeyError: 'course_key' while saving an ORA block ↓

cause Missing or incomplete course context when saving ORA block data.

fix

Ensure the ORA block is saved within a course runtime (e.g., via studio or LMS). This is a known bug fixed in 6.11.1; upgrade if using an older version.

Warnings

breaking Drop of Python 3.11 support in version 7.0.0. Ensure your environment uses Python 3.12 or later. ↓

fix Upgrade to Python 3.12+ and rebuild your virtual environment.

gotcha ora2 depends on edx-platform Django models and signals. Direct use outside an Open edX installation will fail with import errors. ↓

fix Only install ora2 in an Open edX environment (e.g., via tutor or devstack).

gotcha ORA blocks use a custom JavaScript application that may conflict with other XBlock JS. Ensure asset bundling includes ora2's static files. ↓

fix Run `pip install -e .` and `npm install` in the ora2 repo if developing locally.

Imports

OraBlock
```
from ora2 import OraBlock
```
Primary XBlock class for ORA.
OraConfig
```
from ora2.models import OraConfig
```
Configuration model for ORA instances.

Quickstart

Quick import check for ora2; full usage requires an Open edX environment with edx-platform.

import os
from ora2 import OraBlock

# OraBlock is typically loaded by the XBlock runtime, not used standalone.
# Configuration is done via Django admin or settings.
print("ORA2 library imported successfully.")