Kwazi tutoring, taught from your sources.

import { Kwazi } from "kwazi";

const kwazi = new Kwazi(); // reads KWAZI_API_KEY

const notes = await kwazi.sources.create({
  url: "https://your-school.example/grade-7/fractions.pdf",
  subject: "mathematics",
  grade: 7
});

const lesson = await kwazi.lessons.create({
  grade: 7, subject: "mathematics", topic: "Adding fractions", sourceIds: [notes.id]
});
console.log(lesson.steps.map((step) => step.title), lesson.finalAnswer);

// In your web server: a session for the chat widget
app.post("/api/kwazi-session", async (req, res) => {
  const session = await kwazi.widgetSessions.create({ sourceIds: [notes.id], grade: 7, subject: "mathematics" });
  res.json({ token: session.token });
});

from kwazi import Kwazi

kwazi = Kwazi()  # reads KWAZI_API_KEY

notes = kwazi.sources.create("https://your-school.example/grade-7/fractions.pdf", subject="mathematics", grade=7)
lesson = kwazi.lessons.create(7, "mathematics", "Adding fractions", source_ids=[notes["id"]])
print([step["title"] for step in lesson["steps"]], lesson["finalAnswer"])

session = kwazi.widget_sessions.create(source_ids=[notes["id"]], grade=7, subject="mathematics")
# return {"token": session["token"]} from your /api/kwazi-session route

import za.co.kvra.kwazi.Kwazi;
import java.util.List;

Kwazi kwazi = Kwazi.builder().build(); // reads KWAZI_API_KEY

Kwazi.Source notes = kwazi.createSource(
    new Kwazi.SourceInput("https://your-school.example/grade-7/fractions.pdf").subject("mathematics").grade(7));
Kwazi.Answer lesson = kwazi.createLesson(
    new Kwazi.LessonInput(7, "mathematics", "Adding fractions").sourceIds(List.of(notes.id())));
System.out.println(lesson.finalAnswer());

Kwazi.WidgetSession session = kwazi.createWidgetSession(
    new Kwazi.WidgetSessionInput().sourceIds(List.of(notes.id())).grade(7).subject("mathematics"));

curl https://api.kwazi.kvra.co.za/v1/sources \
  -H "Authorization: Bearer $KWAZI_API_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://your-school.example/grade-7/fractions.pdf","subject":"mathematics","grade":7}'

curl https://api.kwazi.kvra.co.za/v1/questions \
  -H "Authorization: Bearer $KWAZI_API_KEY" -H "Content-Type: application/json" \
  -d '{"grade":7,"subject":"mathematics","question":"What is 1/2 + 1/4?","sourceIds":["SOURCE_ID"]}'

<!-- Floating launcher; your /api/kwazi-session route returns {"token": "kwz_ws_…"} -->
<script src="https://kvra-global.github.io/kwazi-sdk/widget/kwazi-widget.js" defer></script>
<kwazi-chat session-endpoint="/api/kwazi-session" heading="Ask Kwazi" accent="#0F766E"></kwazi-chat>

<!-- Or inline, from your own bundle -->
<div id="tutor" style="height:600px"></div>
<script type="module">
  import { mount } from "kwazi-widget";
  mount({
    target: document.getElementById("tutor"),
    inline: true,
    getToken: async () => (await (await fetch("/api/kwazi-session", { method: "POST" })).json()).token
  });
</script>