How piyushkumar920/sage--ai works
Sage AI is an Android curriculum-grounded learning companion, with a Node.js API supporting AI chat and generated study tools. A student selects academic context, studies through a pedagogical tutor or study artifacts, then tracks retention and progress; local data can sync through Firebase. The README documents the product workflow and capabilities, while the sampled backend source shows Gemini calls. Android implementation details and client-to-backend wiring were not sampled, so those relationships are omitted or marked unverified.
Main entry points: MainActivity.kt Android app · server.js Sage API · AdminConsoleScreen.kt Admin console · AcademicProfileRepository.kt Academic profile
Components 19
Android learning app
- Android app
app/src/main/java/com/example/MainActivity.kt - Admin console
app/src/main/java/com/example/ui/admin/AdminConsoleScreen.kt
Curriculum learning
- Academic profile
app/src/main/java/com/example/data/profile/AcademicProfileRepository.kt - Curriculum data
app/src/main/java/com/example/data/curriculum/CurriculumRepository.kt - AI tutor chat
app/src/main/java/com/example/ui/screens/ChatScreen.kt - Chat repository
app/src/main/java/com/example/data/repository/SageRepository.kt
Study and retention
- Study tools
app/src/main/java/com/example/data/studytools/StudyToolsRepository.kt - Quizzes
app/src/main/java/com/example/data/quiz/QuizService.kt - Daily missions
app/src/main/java/com/example/data/mission/DailyMissionRepository.kt - Focus mode
app/src/main/java/com/example/data/focus/FocusRepository.kt - Adaptive review
app/src/main/java/com/example/data/adaptive/AdaptiveLearningRepository.kt - Career roadmaps
app/src/main/java/com/example/data/repository/RoadmapRepository.kt - PYQ archive
app/src/main/java/com/example/ui/screens/pyq/PYQScreenSection.kt
Persistence and sync
- Local Room store
app/src/main/java/com/example/data/local/SageDatabase.kt - Cloud sync
app/src/main/java/com/example/data/sync/SageSyncManager.kt
AI backend
- Sage API
server/server.js
Other components
- Student
- Firebase Firestore
- Gemini
Connections 19
- Student → Android app: uses
README.md - Android app → Academic profile: sets context
README.md - Academic profile → Curriculum data: grounds study
README.md - Student → AI tutor chat: studies with
README.md - AI tutor chat → Chat repository: submits chat
- Chat repository → Sage API: requests AI
- Sage API → Gemini: calls model
server/server.js - Student → Study tools: generates artifacts
README.md - Student → Quizzes: practices recall
README.md - Student → Focus mode: starts sessions
README.md - Student → Daily missions: completes missions
README.md - Student → Adaptive review: reviews weak concepts
README.md - Student → Career roadmaps: explores careers
README.md - Student → PYQ archive: reviews questions
README.md - Android app → Local Room store: persists locally
README.md - Local Room store → Cloud sync: syncs data
README.md - Cloud sync → Firebase Firestore: syncs across devices
README.md - Student → Admin console: administers
README.md - Admin console → Sage API: uses backend