How govindjs5805/helen-ai works
Helen AI is an adaptive learning platform for students and teachers. A representative workflow is: a learner submits material in the document simplifier, the FastAPI backend extracts text (using OCR when needed), generates adapted outputs with AI, and saves or retrieves results. The React app also provides authentication and onboarding, personalized accessibility settings, tutoring, focus and planning tools, and teacher classroom/progress views. Backend internals and several frontend pages were not excerpted; the broader feature branches and their connections below rely on README documentation rather than inspection of those implementations.
Main entry points: main.py FastAPI endpoints · App.tsx React application · DocumentSimplifier.tsx Document simplifier · api.ts API client
Components 21
Learning experience
- React application
helen-ai/src/App.tsx - Sign-in and onboarding
helen-ai/src/pages/Auth.tsx - Session and profile
helen-ai/src/context/AuthContext.tsx - Supabase Auth
- Document simplifier
helen-ai/src/pages/student/DocumentSimplifier.tsx - AI learning assistant
helen-ai/src/pages/AIAssistant.tsx - API client
helen-ai/src/services/api.ts
Accessibility and profiles
- Accessibility settings
helen-ai/src/pages/ReadingSettings.tsx - Reading preferences
helen-ai/src/context/ReadingThemeContext.tsx - Theme preferences
helen-ai/src/context/ThemeContext.tsx
Study support
- Focus and planner
helen-ai/src/pages/FocusMode.tsx - Attention sharing
helen-ai/src/services/attentionApi.ts
Backend processing
- FastAPI endpoints
helen-ai/backend/main.py - Document extraction
helen-ai/backend/main.py - OCR processing
helen-ai/backend/main.py - Gemini AI
- Supabase database
Classroom tools
- Classroom management
helen-ai/src/pages/Classrooms.tsx - Student progress
helen-ai/src/pages/teacher/StudentProgress.tsx - Teacher dashboard
helen-ai/src/pages/teacher/Dashboard.tsx
Other components
- Student / teacher
Connections 22
- Student / teacher → React application: uses
README.md - React application → Sign-in and onboarding: routes to
helen-ai/src/App.tsx - Sign-in and onboarding → Session and profile: authenticates through
README.md - Session and profile → Supabase Auth: manages session
README.md - React application → Document simplifier: routes to
helen-ai/src/App.tsx - Document simplifier → API client: submits material
README.md - API client → FastAPI endpoints: sends requests
README.md - FastAPI endpoints → Supabase Auth: validates token
README.md - FastAPI endpoints → Document extraction: extracts content
README.md - Document extraction → OCR processing: uses when needed
README.md - FastAPI endpoints → Gemini AI: generates adapted output
README.md - FastAPI endpoints → Supabase database: saves results
README.md - FastAPI endpoints → Document simplifier: returns results
README.md - AI learning assistant → API client: requests tutoring
- Accessibility settings → Reading preferences: updates preferences
- Reading preferences → Supabase database: persists preferences
- Student / teacher → Focus and planner: uses study tools
README.md - Focus and planner → Attention sharing: shares summaries
- Student / teacher → Classroom management: uses classroom tools
README.md - Teacher dashboard → Student progress: views progress
README.md - Teacher dashboard → Classroom management: manages classes
README.md - Theme preferences → Supabase database: persists settings