Skip to content

Offline AI-powered teaching assistant built with RunAnywhere SDK

Notifications You must be signed in to change notification settings

Deepak-Kambam/TutorMe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TutorMe - AI-Powered Teaching Assistant

Empowering Teachers with Offline AI - Anywhere, Anytime

Build Status SDK Version Android API License

What is TutorMe?

TutorMe is a revolutionary offline AI teaching assistant built specifically for educators in rural or low-connectivity areas. Using the RunAnywhere SDK, it brings powerful AI capabilities directly to Android devices without requiring internet connectivity or expensive cloud APIs.

The Problem We Solve

  • Rural teachers lack access to AI-based teaching tools
  • Internet connectivity issues prevent use of cloud-based AI
  • Cost barriers from paid API services and subscriptions
  • Privacy concerns with cloud-based data processing
  • Time constraints in preparing quality educational content

Our Solution

A complete offline AI teaching assistant that generates professional educational content instantly, privately, and affordably.

Key Features

Topic-to-Lesson Generator

  • Enter any topic → Get a full lesson outline
  • Customizable for different grade levels and subjects
  • Includes objectives, materials, activities, and assessments

AI Quiz Creator

  • Auto-generate multiple choice questions
  • Configurable question count (3-15 questions)
  • Includes answer keys and explanations
  • INTERACTIVE SCORING - Shows marks and performance levels

Explain It Simply

  • Converts complex topics into student-friendly language
  • Multiple complexity levels (Simple to Detailed)
  • Real-world examples and analogies

Summarize Notes

  • ENHANCED: Works with notes OR topics
  • Converts long content to teaching bullet points
  • Customizable summary lengths

Offline AI Engine

  • COMPLETE MODEL MANAGEMENT - Download, load, refresh models
  • 3 education-optimized AI models included
  • Advanced UI with real-time progress tracking
  • 100% privacy - all processing on-device

Save & Reuse

  • Local storage for all generated content
  • Search and filter saved lessons
  • Favorites and organization system

Advanced UI/UX Design

Premium Animations

  • Spring physics animations with natural bounce effects
  • Rotating refresh buttons and progress animations
  • Smooth slide-in and fade transitions
  • Animated quiz result displays with circular progress

Professional Design

  • Material 3 design system with custom color theming
  • Gradient headers and elevated cards
  • Status indicators and smart badges
  • Responsive design for all screen sizes

Navigation Excellence

  • 3-tab bottom navigation (Generate, History, AI Models)
  • Floating action button for quick model access
  • Dynamic badges showing content counts
  • Smooth navigation with state preservation

Technical Architecture

Clean Architecture Pattern

TutorMe/
├── data/          # Room database, repositories, models
├── domain/        # Use cases and business logic  
├── ui/            # Compose screens and components
├── viewmodel/     # State management and UI logic
└── utils/         # AI prompts and utilities

Technology Stack

  • Frontend: Jetpack Compose with Material 3
  • Architecture: MVVM + Use Cases (Clean Architecture)
  • Database: Room with KSP code generation
  • AI Engine: RunAnywhere SDK with llama.cpp
  • Animations: Compose Animation API
  • State Management: StateFlow and Compose State

Getting Started

Requirements

  • Android device with API 26+ (Android 8.0+)
  • ARM64 processor (most modern Android devices)
  • 2GB+ RAM (4GB recommended for larger models)
  • 500MB - 2GB storage (depending on AI model choice)

Installation

  1. Download APK from releases
  2. Install on Android device
  3. Open app and navigate to "AI Models" tab
  4. Download a model (SmolLM2 360M recommended for first time)
  5. Load the model and start generating teaching content!

Model Recommendations

  • SmolLM2 360M (119MB) - Fast, perfect for quick responses
  • Qwen 2.5 0.5B (374MB) - Balanced quality and speed
  • Llama 3.2 1B (815MB) - Highest quality, requires 3GB+ RAM

For Educators

Perfect For:

  • Rural teachers with limited internet access
  • Budget-conscious schools avoiding subscription costs
  • Privacy-focused educators keeping data secure
  • Tech-savvy teachers wanting modern AI tools

Use Cases:

  • Generate lesson plans for any subject and grade level
  • Create quizzes with automatic scoring and feedback
  • Explain complex concepts in simple terms
  • Summarize lengthy teaching materials
  • Save and organize all generated content locally

Global Impact

TutorMe democratizes access to AI-powered education tools by:

  • Removing connectivity barriers for rural educators
  • Eliminating cost barriers with one-time setup
  • Ensuring privacy with on-device processing
  • Providing professional quality educational content generation

Development Setup

Build from Source

git clone [repository-url]
cd Hackss
./gradlew assembleDebug

Dependencies

  • RunAnywhere SDK (included in app/libs/)
  • Jetpack Compose BOM
  • Room database with KSP
  • Material 3 and Navigation Compose

Performance & Quality

  • Build Status: Compiles successfully with zero errors
  • Code Quality: 100% Kotlin with null safety and type safety
  • UI Performance: Smooth 60fps animations and interactions
  • Memory Efficient: Optimized for mobile device constraints
  • Offline First: Works completely without internet after setup

Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests for:

  • New AI model integrations
  • Additional educational features
  • UI/UX improvements
  • Localization support

License

MIT License - see LICENSE file for details.

Acknowledgments

  • RunAnywhere Team for the incredible on-device AI SDK
  • Open source community for the foundational libraries
  • Educators worldwide who inspired this solution

TutorMe: Making AI-Powered Education Accessible to Every Teacher, Everywhere

About

Offline AI-powered teaching assistant built with RunAnywhere SDK

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages