functional architecture
every student. one Cognee Cloud tenant.
The browser holds zero learning state. The backend scores mastery and walks the curriculum graph.
SQLite keeps the exact classroom ledger, while Cognee Cloud stores long-term student memory, class memory,
recall surfaces, learning traces, and teacher interventions.
1. actstudents answer, ask, reset, enroll, import curriculum; teachers ask, plan, assign
2. reasonFastAPI validates input, walks prerequisites, scores mastery, and ranks teaching priorities
3. rememberSQLite stores exact state; Cognee stores student memory, class graph, sessions, traces
4. returnUI receives graph state, next step, reports, class plan, answer sources, and provenance
Student + teacher UI
Student mastery, quiz, ask box, report card, timeline, graph inspector, class ask, teaching
plan, roster setup, curriculum import, and review assignment.
no browser statevis-networkstudent pageteacher page
REST API
/quiz · /ask · /student · /class · /teacher · /curriculum
Provider + graph reasoning engine
Validates requests, selects frontier concepts, scores quiz answers, builds report data,
ranks graph-reasoned teaching plans, and keeps demo/cloud modes behind one response shape.
app.pyDemoProviderCloudProviderasync SDK bridge
exact mastery state
weights, timestamps, rosters, seeded datasets, interventions
Cognee memory ops
serve · remember · recall · session memory · node sets · forget
Mastery ledger
Durable exact state for the classroom: students, concept weights, update timestamps, retired
flags, seeded datasets, tenant metadata, and intervention assignments.
mastery_ledger.sqlitestudentsmasteryinterventions
Hosted classroom memory
Cognee stores private student datasets, a dense class graph, session-memory quiz attempts,
progress snapshots, report-card recall context, and teacher intervention memory.
student_aliceclass_graphclass_interventions
curriculumprogressmastery-traceteaching-plan
response back to UI
next step, graph colors, reports, teaching plan, answer sources, class gaps, provenance
What changes for users
Students see what to learn next and why. Teachers see the class heat map, a graph-reasoned
lesson plan, targeted review lists, and per-student drill-down.
student graphtimelinereport cardteacher plan
class heat mapreview list
quiz answerFastAPI updates SQLite weights, writes session memory, and emits mastery traces when concepts turn green
student ask + reportCognee recall reads the student's dataset and returns grounded answers or a report card
teaching planBackend ranks ready class gaps by prerequisite readiness and downstream unlock value, then writes the plan to class memory
class askTeacher questions use the dense class_graph or fall back to multi-dataset recall across student memories
assign reviewTeacher action persists an intervention in SQLite and writes a teacher-intervention memory to Cognee
setup + resetRoster setup creates fresh student memories; reset clears local state and calls Cognee forget(dataset)