Skip to content

Saconyfx/Donmark

Repository files navigation

Donmark

AI-Powered Education Platform

Built during a 24-hour hackathon · 100% success rate · donmark.org


Table of Contents


Introduction

Donmark is an autonomous AI education platform that delivers personalised, structured learning across five academic subject tracks. Students progress through AI-generated lessons narrated by a human-like voice, engage with a live AI tutor mid-lesson, take adaptive quizzes and timed final exams, and earn platform-verified certificates on completion.

Built with FastAPI on the backend and powered by Anthropic Claude, ElevenLabs, and Gemini, Donmark is designed for students in under-resourced environments who need access to quality education without relying on expensive tutors or unstructured internet browsing.


The Problem We Are Solving

Students today face a fundamental gap between access to information and access to real education.

Most turn to Google or general-purpose AI chatbots to study. The result is an answer not an education. There is no curriculum, no progression, no assessment, and no proof of what was learned. Students are left to self-direct everything, and most do not.

Donmark solves this in three ways:

  1. No structure → We replace open-ended chat with a guided lesson-quiz-exam curriculum per subject
  2. No accountability → Every lesson has check-in questions, quizzes test comprehension, and exams confirm mastery
  3. No proof → Students who pass earn a certificate with a unique ID publicly verifiable at donmark.org/verify.html

Why Donmark, Not a Chatbot

When a student opens ChatGPT or any general AI chatbot to study, this is what happens:

  • They type a question into a blank box
  • They get a wall of text back
  • There is no follow-up, no quiz, no check on whether they understood
  • Nothing is saved, nothing progresses, nothing is proven
  • The next day they do the same thing again from scratch

Donmark is different because the AI is the teacher, not just the answer machine.

We built Donmark specifically to fix this:

  • It generates coherent, curriculum-structured lesson content consistently
  • It adapts its explanations to the student's subject and grade level
  • It powers a live mid-lesson tutor that students can speak to directly
  • It produces adaptive quiz questions based on each student's weaker check-in answers
  • It is safer and more reliable for educational content than general-purpose alternatives

The entire teaching loop lesson generation, tutor responses, quiz creation, exam questions — runs through Claude. Students are not searching for information. They are being taught by it.


Features

Feature Powered By How We Used It
AI-Generated Lessons Anthropic Claude Claude generates the full lesson content — slides, explanations, and examples — fresh every session, tailored to the student's subject and grade level
Human Voice Narration ElevenLabs Every lesson slide is narrated aloud using ElevenLabs TTS, giving students a real listening experience instead of reading walls of text
Push-to-Talk AI Tutor Anthropic Claude + ElevenLabs Students hold a button mid-lesson to ask a question verbally — Claude generates the answer and ElevenLabs speaks it back in real time
AI Tutor Gate Anthropic Claude + ElevenLabs After every slide, Claude generates a follow-up comment, ElevenLabs speaks it, and the student cannot advance until it finishes — enforcing active engagement
Smart Adaptive Quizzes Anthropic Claude Claude generates 5 quiz questions per lesson specifically targeting the topics the student answered weakly during in-lesson check-ins
30-Question Final Exams Anthropic Claude Claude generates a unique 30-question exam per subject, auto-graded with a 50% pass threshold and a 60-minute timer
Verified Certificates Supabase + SHA-256 A unique Certificate ID is generated on pass and stored in Supabase — publicly verifiable at donmark.org/verify.html
AI Note Scanner Google Gemini Vision Students photograph handwritten notes and Gemini Vision transcribes them into clean digital text saved directly to their notes
Notes AI Tools Anthropic Claude + ElevenLabs + OpenAI DALL-E 3 Claude summarises notes and generates flashcards, ElevenLabs reads notes aloud, and DALL-E 3 generates images from note content
Pomodoro Study Timer Custom Focus timer with configurable sessions, session logging to Supabase, and streak tracking visible on the dashboard
Live Progress Dashboard Supabase Real-time view of lessons done, quiz scores per topic, exam results, daily study time, streak days, and subject completion
Backend & Hosting FastAPI + DigitalOcean The entire API — lesson generation, exam grading, voice synthesis, note scanning — runs on FastAPI deployed to DigitalOcean App Platform
Database & Auth Supabase All student data, progress, exam results, notes, and study sessions stored and authenticated through Supabase
Demo Account Pre-loaded demo account with all subjects completed so anyone can explore the full platform without signing up

AI Stack

Tool Role
Anthropic Claude Lesson generation, quiz and exam creation, live AI tutor, note summarisation and flashcards
ElevenLabs Voice narration for all lesson slides, AI tutor spoken responses, notes read-aloud
Google Gemini Vision Handwritten note scanning and transcription
OpenAI DALL-E 3 AI image generation inside the notes editor
DigitalOcean Backend hosting via App Platform
Supabase Database, authentication, and real-time data

Subjects

Each subject contains 5 topics, 5 quizzes, and 1 final exam.

# Subject Topics
01 Health Sciences Human Body Systems · Nutrition & Diet · Mental Health · Disease & Prevention · First Aid & Safety
02 Mathematics Intro to Algebra · Linear Equations · Quadratic Equations · Statistics & Data · Geometry
03 Environmental Studies Ecosystems · Climate Change · Biodiversity · Sustainable Development · Environmental Policy
04 Computer Science & Cybersecurity Intro to Programming · Data Structures · Networks & Internet · Cybersecurity Basics · AI & Machine Learning
05 Business Studies Entrepreneurship · Marketing Basics · Financial Literacy · Business Ethics · Global Economy

Demo Account

A pre-loaded demo account lets anyone explore the full platform without signing up.

On the login page click "Try Demo" to auto-fill, or enter manually:

Email:    demo@donmark.org
Password: demoAcc1234@

The demo account comes pre-loaded with all five subjects completed, five certificates earned, and four weeks of study history so you can see the full dashboard in action.

What you can do with the demo:

  • Start or reset any lesson and work through it from scratch
  • Use the push-to-talk AI tutor during lessons
  • Take quizzes and the final exam
  • Create, edit, and organise notes
  • Use all AI note tools summarise, flashcards, read-aloud, image generation
  • Use the study timer
  • View and download certificates

What is disabled on the demo:

  • Changing your name, avatar, email, or password this keeps the demo looking consistent for everyone who tries it

Usage

  1. Sign up with your email and password, or use the demo account to explore
  2. Select a subject from your dashboard and begin with Topic 1
  3. Work through each lesson the AI tutor will speak after every slide
  4. Use push-to-talk to ask the tutor questions verbally at any point
  5. Complete the quiz after each lesson to save your progress
  6. After all five topics, take the 30-question final exam
  7. Pass with 50% or above to earn your certificate
  8. Download or print your certificate verify it at donmark.org/verify.html

Installation

Donmark is fully deployed and live no installation required.

Visit: donmark.org

Create a free account and start learning immediately, or use the demo account to explore the full platform without signing up. The backend, database, and all AI services are managed and hosted nothing to set up on your end.

License

This project was built during a 24-hour hackathon and is currently closed-source. The frontend HTML files are available for review in this public repository. The backend (main.py) containing API integrations and business logic is private.

Contact the Donmark team via donmark.org for access or collaboration enquiries.

Contributing

Donmark is currently maintained as a private project. If you would like to report a bug, suggest a feature, or contribute to the frontend, please open an issue in this repository or reach out via donmark.org.

Disclaimer

Donmark is an independent AI education platform and is not affiliated with any school, university, examination board, or government body. Certificates issued by Donmark reflect completion of AI-generated coursework on the platform and are not equivalent to formal academic qualifications. All lesson content is AI-generated and intended for educational enrichment it should be verified against official curriculum materials where applicable.

About

AI-powered learning platform for students.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages