Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hawkings.education/llms.txt

Use this file to discover all available pages before exploring further.

​
Why Hawkings

Building educational software has always meant building the same boring plumbing over and over: a course tree, a lesson editor, a quiz engine, a gradebook, a SCORM exporter, an LMS sync. Then, one day, the team that just shipped that plumbing is asked to “add AI.” A year of prompt engineering later they have a tutor that hallucinates and a grader nobody trusts. We did the boring plumbing for you, and we did the AI plumbing for you, and we made one boring API out of both. Hawkings is what you’d reach for if you were building Duolingo, Coursera, or a corporate LMS in 2026, and you had three weeks instead of three years.

Quickstart

First successful API call in under 60 seconds.

Generate a course from a syllabus

From a paragraph of text to a fully-structured course in one call.

Build an AI tutor

Add a grounded, per-lesson tutor chat to your product.

Grade with AI

Open-ended grading with rubric, rationale, and human-in-the-loop.

​
What’s in the box

A complete course graph

Workspaces, courses, cohorts, units, lessons, lesson contents, activities, questions, assignments, submissions, users.Read it, write it, sync it. The graph is consistent across every surface — your dashboard, your students’ app, your LMS export.
Quizzes (true/false, fill-in-the-blank, matching, grouping, open-ended, …), flashcards, podcasts, diagrams, glossaries, bibliographies, explainers, summaries, audio resumes, integrative activities… all of them are activities.create({ type, ... }). No separate endpoints, no separate types in your code.
courses.generateSyllabus(), activities.generate(), lessonContents.generate(). Every generation is async, returns a handle, and you can poll() or webhook-listen for completion.
submissions.gradeWithAi() returns the score and the reasoning. Pair it with submissions.update() for a human-in-the-loop workflow.
scorm.create({ cohort_id }) produces a SCORM 1.2 / 2004 zip your customers can drop into Moodle, Canvas, Cornerstone — anything.
First-class adapters for Moodle, with Canvas and Schoology coming next. Your customers stay where they are; you ship the AI layer on top.

​
A taste

import Hawkings from "@hawkings/sdk";

const hk = new Hawkings({ api_key: process.env.HAWKINGS_API_KEY });

// Generate a course from a one-paragraph brief
const course = await hk.courses.create({
  name: "Intro to Special Relativity",
  language: "en",
  hours: 12,
});

await hk.courses.generateSyllabus(course.id, {
  brief: "An introductory undergraduate course on special relativity, " +
         "ending with the equivalence of mass and energy.",
});

// Generate one lesson's worth of activities
const lesson = (await hk.lessons.list({ cohort_id: course.cohorts[0] })).data[0];
const activities = await hk.activities.generate({
  lesson_id: lesson.id,
  count: 5,
  types: ["explain", "quiz", "flashcard"],
});
That’s it. The boring plumbing, gone.

​
Where to next