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 result = await evaluator.evaluate("The cat's out of the bag now.");
console.log(result.score); // 4-5

​
SDK release history

​
TypeScript

Read the full changelog here.
DateChangedVersion
May 22, 2026Added bypassRowLimit option for the batch evaluatorv0.6.0
May 07, 2026Added support for Purpose evaluator. Added modelOverride option to all evaluators.v0.5.0
March 23, 2026Added Batch CSV Evaluator.v0.4.0
March 20, 2026Added support for Conventionality Evaluator.v0.3.0
March 18, 2026Added support for Subject Matter Knowledge Evaluator.v0.2.0
March 13, 2026First release.v0.1.0

​
Python

Read the full changelog here.
DateChangedVersion
May 22, 2026First release.v0.1.0