Skip to content
A Flask app to bulk update grades in Canvas LMS based on Outcome results
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Learning Mastery Grades Calculator

This Flask application hooks into Canvas to associate Outcome scores with actual assignments.

This is very much a work in progress.

What does it do?

If you want to use Outcomes to dictate assignment scores, you have to do that one by one by hand in the gradebook. This means either using a dual-monitor setup to open both at the same time or clicking back and forth for each and every assignment. This app creates a relationship between an assignment and an outcome and then uses the Canvas API to update the gradebook in bulk.

Here's a practical example:

Outcome 1.1 defines a skill students should have. An Outcome score of 3.0 is considered 'passing.' Assignment 1.1 in the traditional gradebook is set to 1/1 when a 3.0 is reached on the Outcome. Currently, you have to update this score by hand.

This app allows the instructor to set a relationship between a single Outcome and an Assignment. When the mastery score is reached on the Outcome, the Assignment is automatically toggled to full credit for each student.

What about student data?

No student data is stored in the app. The database is used to map an Outcome to an Assignment (and vice versa) using the item ID from Canvas. When the app runs, the stored IDs are queried and loaded into the dashboard for the user. Student scores are updated in real time via the API. As soon as the user logs out, the student data is cleared from the session.


pip install -r requirements.txt


Add a Developer Key for the application in your Canvas instance.

Set up your config with cp in your directory. Update your config file with your Canvas Developer Key specifics. Make sure you edit your URL root in each of the URLs listed.

The API calls to Canvas are all done with UCF Open's CanvasAPI library.

Canvas Course Structure

The settings are not configurable right now. To use the application, you should have the following:

  • Outcomes imported into your Canvas course.
  • Assignments assessing the Outcomes (either quizzes or rubrics)
  • Assignments to be updated by the app. These assingments should be worth one point each.

When a student reaches master (Outcome aggregate = 3 or higher) the linked Assignment will be toggled to 1/1. If it is below 3, the Assignment is toggled to 0/1.



  • Database models
    • outcomes
    • assignments
  • Link assignment to outcome
  • Per-student reporting
  • Routing
    • Login required view
    • standardize id structures
    • Student view?
  • Update assignment scores on Canvas
  • Flask-Session for server-side key storage
  • Flask-Cache to reduce API calls
  • Config
    • User-defined Mastery score
    • User-defined Assignment toggle


  • OAuth2 Login
    • Refresh OAuth session
  • Canvas object for API calls


  • navbar
  • App config settings
  • Config Canvas URL
  • Dashboard
    • Course picker
  • Course
    • Define assignment category ID
      • Fetch assignments in the group
    • Import course outcomes by group
    • Separate rosters by course section


Active courses

Active courses

Align Outcomes to Assignments


Student scores

Student scores

You can’t perform that action at this time.