Skip to content

Jay-Karia/ekalavya

Repository files navigation

Ekalavya

AI-Powered Academic Mentor for First-Generation Learners

React Native Expo TypeScript License


📖 About

Ekalavya is a mobile application designed to democratize education for first-generation learners. This app provides AI-powered mentorship, personalized learning paths, and career guidance to students who may not have access to traditional academic support systems.

Why Ekalavya?

  • 🎯 Personalized Learning: AI-driven course recommendations tailored to individual learning styles
  • 🤖 AI Mentor: 24/7 intelligent tutoring assistance for academic queries
  • 📚 Course Library: Comprehensive collection of courses across various subjects
  • 🎓 Career Guidance: Professional pathways and skill development recommendations
  • ✍️ Interactive Quizzes: Assess and track your learning progress
  • 👨‍🏫 Course Creator: Create personalized courses.
  • 🌏 Real-World Applications Teaching: Get courses for real world applications and life lessons.
  • 📔 Reverse peer-to-peer Learning: Teach basic knowledge to parents to sustain a healthy life.

✨ Features

🏠 Dashboard

  • Clean, intuitive interface with quick access to all features
  • Progress tracking and learning statistics
  • Personalized recommendations based on your learning journey

📚 Course Management

  • Browse extensive course catalog
  • Track enrolled courses
  • Monitor completion rates and achievements
  • Create courses from textbook images
  • Get courses of real world applications

🤖 AI Mentor

  • Real-time chat with AI-powered tutor
  • Subject-specific assistance
  • Contextual learning support
  • Customize the behavior and tone of the AI mentor

🎯 Interactive Quizzes

  • Subject-wise assessments
  • Instant feedback and explanations
  • Performance analytics

🚀 Career Guidance

  • Career path recommendations
  • Skill gap analysis
  • Industry insights and trends

🛜 Low / No Internet

  • Access learning materials offline
  • Sync progress when back online

🛠️ Tech Stack

Frontend

  • React Native (0.81.5) - Cross-platform mobile development
  • Expo (~54.0) - Development and build tooling
  • TypeScript (5.9) - Type-safe code
  • Expo Router (6.0) - File-based navigation

UI/Styling

  • Tamagui (2.0.0-rc) - Universal UI components
  • NativeWind (4.2) - Tailwind CSS for React Native

State Management & Backend

  • React Context API - Global state management
  • React Native Appwrite (0.20) - Backend as a Service
  • AsyncStorage - Local data persistence

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/ekalavya.git
    cd ekalavya
  2. Install dependencies

    npm install
  3. Set up environment variables

    Create a .env file in the root directory and add your Appwrite and OAuth credentials:

    EXPO_PUBLIC_APPWRITE_PROJECT_ID
    EXPO_PUBLIC_APPWRITE_PROJECT_NAME
    EXPO_PUBLIC_APPWRITE_ENDPOINT
    EXPO_PUBLIC_DATABASE_ID
    EXPO_PUBLIC_USERS_COLLECTION_ID
    
    GOOGLE_CLIENT_SECRET
    GOOGLE_CLIENT_ID
    GOOGLE_ANDROID_CLIENT_ID
  4. Start the development server

    npm run start
  5. Run on your device

    • iOS: Press i in the terminal or scan QR code with Camera app
    • Android: Press a in the terminal or scan QR code with Expo Go app
    • Web: Press w in the terminal

📱 Usage

  1. Sign Up/Sign In: Create your account or log in to access personalized features
  2. Explore Dashboard: Navigate through various learning modules
  3. Browse Courses: Discover courses that match your interests
  4. Chat with AI Mentor: Get instant help with your academic questions
  5. Take Quizzes: Test your knowledge and track progress
  6. Career Planning: Explore career paths and get personalized recommendations

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with 💙 for the education community

About

AI Academic Mentor for first-generation learners

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors