Skip to main content
Our SDKs let you use evaluators in your own project. You can:
  • Configure evaluators
  • Understand their outputs
  • Evaluate text in batches  TypeScript only
  • Handle errors
  • Customize logging
  • Send telemetry data

​
Installation

Install the SDK of your choice:
LanguageInstallationLatest version
TypeScriptGitHub ↗npm version
PythonGitHub ↗PyPI version
Contact us ↗ to request additional SDK language support. You can also sign up on the Learning Commons Platform ↗ for updates on availability.

​
Quickstart

import { GradeLevelAppropriatenessEvaluator } from "@learning-commons/evaluators";

const evaluator = new GradeLevelAppropriatenessEvaluator({
  googleApiKey: process.env.GOOGLE_API_KEY,
});

const text = "The cat's out of the bag now.";

const result = await evaluator.evaluate(text);
console.log(result.score); // 4-5

​
SDK release history

​
TypeScript

Read the full changelog here.
DateChangedVersion
Jun 11, 2026Added --help, --version, and other options to the batch evaluatorv0.7.0
May 22, 2026Added --bypass-row-limit option for the batch evaluatorv0.6.0
May 07, 2026Added support for Purpose evaluator. Added modelOverride option to all evaluatorsv0.5.0
March 23, 2026Added Batch CSV Evaluatorv0.4.0
March 20, 2026Added support for Conventionality Evaluatorv0.3.0
March 18, 2026Added support for Subject Matter Knowledge Evaluatorv0.2.0
March 13, 2026First releasev0.1.0

​
Python

Read the full changelog here.
DateChangedVersion
Jun 11, 2026Added support for the Grade Level Appropriateness Evaluatorv0.2.0
May 22, 2026First releasev0.1.0