A next-generation educational platform for Physical AI & Humanoid Robotics that adapts to every reader's skill level, speaks their language with one-click Urdu translation, and answers their questions through a RAG chatbot grounded exclusively in the book's own content.
This project answers a fundamental question: What will the book of tomorrow look like?
Today's digital books are simply scanned versions of print — they do not know who is reading, what the reader already knows, or what language they speak. This platform introduces a new model for educational content built around three core capabilities:
The platform asks users whether they are a beginner, intermediate, or advanced learner, then adjusts the entire book experience to match their level.
The full book translates to Urdu instantly, removing the language barrier for millions of readers across Pakistan, India, and the Middle East.
An integrated AI assistant that answers questions exclusively from the book's own content — providing cited, accurate responses without hallucination.
"This is not just a robotics textbook. It is a working demonstration of how every educational book — medical, legal, engineering, or scientific — will function in the near future."
Traditional educational books deliver identical content to every reader. In practice, learners arrive with vastly different backgrounds — a single static book cannot serve all of them effectively.
| Student | Background | Problem with a Static Book |
|---|---|---|
| Hamza | No prior programming experience | Advanced content is incomprehensible — he drops out |
| Sana | 3 years of Python experience | Basics she already knows waste her time |
| Ali | Professional software engineer | Cannot skip to advanced material without losing structure |
Beyond level mismatch, four additional pain points block learners:
| Problem | Impact |
|---|---|
| Language barrier — content in English only | Non-native English speakers struggle to absorb technical concepts |
| No built-in Q&A support | Students leave the book to search online, finding outdated or incorrect answers |
| Generic content structure | No recognition of the reader's hardware, OS, or prior knowledge |
| Broken code examples | Version mismatches in ROS 2 / Isaac Sim block student progress |
During signup, users answer two targeted questions before accessing the book: their software background (Beginner / Intermediate / Advanced) and their hardware/OS. These answers create a persistent learning profile stored in the backend.
When the user navigates to the book, the skill level is embedded in the URL as a query parameter:
https://book.site/module1/intro?level=beginner https://book.site/module1/intro?level=intermediate https://book.site/module1/intro?level=advanced
The Docusaurus-based book reads this parameter and renders the appropriate version of each chapter. Beginners receive fuller explanations; advanced readers get direct access to theory, code, and edge cases.
Over 100 million Urdu-speaking students across Pakistan, India, and the Middle East face a compounding disadvantage: learning complex technical subjects in a second language. A single translation button eliminates this barrier entirely.
Every page includes an "اردو" button. On click: page content switches to Urdu, technical terms (ROS 2, URDF, Nav2) stay in original form, layout switches to RTL, and the preference is saved for all future visits.
| Region | Benefit |
|---|---|
| Pakistan | Urdu is the national language — removes the English technical barrier entirely |
| India | Large Urdu-speaking population gains full access to advanced technical content |
| UAE / Saudi Arabia | Pakistani and Indian diaspora in the Gulf can study in their mother tongue |
A student doesn't understand a concept in Chapter 4. They leave the book, search Google, ask ChatGPT — and receive an outdated or incorrect answer. The student loses trust and momentum.
The integrated AI assistant reads only this book and answers only from its content — with a citation pointing to the exact chapter and section.
User submits a question
↓
OpenAI Embeddings → question converted to a vector
↓
Qdrant Vector DB → semantically similar book passages retrieved
↓
RAG Pipeline → retrieved context + question sent to GPT-4
↓
Response generated → answer + citation (chapter, section, page)
↓
PostgreSQL → conversation saved for continuity
| Service | Responsibility |
|---|---|
openai_service.py | Text embeddings and GPT-4 response generation |
qdrant_service.py | Vector similarity search across indexed book content |
postgres_service.py | Conversation history — store and retrieve by session |
rag_service.py | Orchestrates the full pipeline end to end |
┌──────────────────────────────────────────────────────────────┐ │ USER JOURNEY │ │ │ │ Landing Page → Signup (2 questions) → Dashboard │ │ ↓ │ │ Learning Profile Saved │ │ ↓ │ │ Book URL + ?level=beginner / intermediate / │ │ advanced │ │ ↓ │ │ ┌─────────────────────────────────────┐ │ │ │ ADAPTIVE BOOK │ │ │ │ Docusaurus v3 · GitHub Pages │ │ │ │ • Level-appropriate content │ │ │ │ • One-click Urdu translation │ │ │ │ • Embedded chatbot widget │ │ │ └──────────────────┬──────────────────┘ │ │ │ │ │ ┌─────────────▼──────────────┐ │ │ │ RAG CHATBOT │ │ │ │ FastAPI Backend │ │ │ │ OpenAI · Qdrant · PG │ │ │ └────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘
| Layer | Technology |
|---|---|
| Frontend | Next.js 14 + TypeScript + Tailwind CSS |
| Authentication | Better Auth (signup, signin, session management) |
| Backend API | FastAPI (Python) |
| AI / LLM | OpenAI GPT-4 + text-embedding-3-small |
| Vector Database | Qdrant (indexed book content embeddings) |
| Relational Database | PostgreSQL (users, learning profiles, conversations) |
| Book Platform | Docusaurus v3 — multi-instance (main site + 4 modules) |
| Deployment | Vercel (frontend) · Render (backend) · GitHub Pages (book) |
?level= query parameter appended to every book URL from the dashboarddir="rtl" toggled dynamically on translation activationThe platform also compares favourably against traditional digital books on every dimension:
| Dimension | Traditional Digital Book | This Platform |
|---|---|---|
| Audience awareness | None — same for everyone | Knows the reader's level from signup |
| Content delivery | Fixed | Adapts to beginner / intermediate / advanced |
| Language | English only | English + one-click Urdu |
| Questions | Reader goes to Google | Built-in chatbot, answers from the book |
| Answer quality | Unverified, potentially outdated | Cited, grounded in book content only |
| Interactivity | Passive reading | Active conversation with the content |
We build intelligent educational systems that know who the learner is and adapt to serve them perfectly.