@learning-commons/evaluators

TypeScript SDK for Learning Commons evaluators.

Installation

Install the @learning-commons/evaluators and Vercel AI SDKs:

npm install @learning-commons/evaluators ai

Next, install the provider adapter(s) for your LLM(s):

npm install @ai-sdk/openai     # OpenAI
npm install @ai-sdk/google     # Google Gemini
npm install @ai-sdk/anthropic  # Anthropic

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

Documentation

| Evaluator | Documentation | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | Grade Level Appropriateness | Link | | Subject Matter Knowledge | Link | | Vocabulary | Link | | Sentence Structure | Link | | Conventionality | Link | | Purpose | Link |

For more implementation details, visit our docs site.

License

MIT