Introduction
Welcome to the PyAutoGrader documentation. PyAutoGrader is a free automated Python grading tool for educators. Students run the grader on their own machines, getting instant feedback on their code.
Quick Links
- Overview - What PyAutoGrader does and how it works
- Download and Install - Get the instructor, student, and server applications
- Instructor Setup - Create assignments and configure tests
- Test Types Reference - Full catalog of 60+ test types
- Student Usage - How students run the grader
For Instructors
Start with the Overview to understand the workflow, then Download and Install to get the applications, and follow Instructor Setup to create your first assignment.
Advanced Topics
- Saving and Exporting - File formats, JSON export/import, distributing assignments
- Batch Grading - Grade folders of student submissions with CSV output
- Roster Setup - Optional student roster validation with CSV, Google Sheets, or server API
- Reporting Setup - Configure email, Google Sheets, server, and webhook channels
- Server Setup - Self-hosted submission server with dashboard, analytics, and plagiarism detection
- Troubleshooting - Common errors and fixes
For Students
Your instructor will provide you with a .agr assignment file. Download the student app from the Student Downloads page, load the file, and run the grader against your code. See Student Usage for a full walkthrough.