pyaota

pyaota is a Python application for generating and grading multiple-choice and true/false exams. It provides:

• Exam generation with randomizable questions from YAML question banks

• Automatic grading of scanned answer sheets using computer vision and OCR

• Answer sheet rendering with QR codes and bubble fields via LaTeX/TikZ

• Email delivery of graded exams to students

• PDF bundling utilities for print management

Note

pyaota is under active development.

Contents

• Installation
  • Requirements
  • Install from source
  • Optional dependencies
• Usage
  • Global options
  • Subcommands
• Grading
  • Typical workflow
  • Answer key format
  • Scoring
  • Gradebook integration
  • Failed pages
  • Interactive mode
  • Question-level statistics
  • Debug output
• Examples
  • Math quiz (MCQ only)
  • History exam (MCQ + True/False)
  • Programming quiz (code-block stems)
  • Compile-dump (review / proofreading)
  • Blank answer sheet
  • Answer keys summary
  • Tips
• YAML Question Schema
  • Top-Level Structure
  • Question Structure
  • Stem Blocks
  • Choices
  • Correct Answer and Explanation
  • Output Formatting Rules
  • Newline Rules
  • Summary of Constraints
• Changelog
  • [0.4.0] - 2026-03-24
  • [0.3.0] - 2026-02-27
  • [0.2.0] - 2026-01-26
  • [0.1.0] - 2026-01-26
  • Breaking Changes Policy
  • Deprecation Warnings
  • Contributing to Changelog
  • See Also
• API Reference
  • pyaota package