QTI Package Maker

qti_package_maker is a Python package and CLI for converting Blackboard Question Upload (BBQ) text files into QTI packages and other export formats (Canvas QTI v1.2, Blackboard QTI v2.1, human-readable text, and HTML self-tests). It is aimed at instructors and developers who need to move assessments across LMSs.

Documentation

Core docs:

• docs/INSTALL.md: Setup and dependencies.
• docs/USAGE.md: CLI usage and examples.
• docs/FORMATS.md: Input/output formats and engine list.
• docs/TROUBLESHOOTING.md: Common issues and fixes.
• docs/CODE_ARCHITECTURE.md: System design overview.
• docs/FILE_STRUCTURE.md: Repo layout and file map.

More docs:

• docs/DEVELOPMENT.md: Developer workflows and testing.
• docs/CHANGELOG.md: Change history.

Quick start

python3 -m venv .venv
source .venv/bin/activate
pip install -r pip_requirements.txt
pip install -e .
python3 tools/bbq_converter.py -i bbq-example-questions.txt -1

Input files must follow the bbq-<name>-questions.txt naming pattern. For the BBQ format and more examples, see docs/USAGE.md.