Sahayak empowers rural teachers with AI-driven educational tools to create engaging content, worksheets, lesson plans, and interactive learning materials with minimal resources. Built with cultural sensitivity and designed for low-resource environments.

• 🌐 Offline-Ready: Works with limited internet connectivity
• 📱 Mobile-First: Optimized for smartphones and tablets
• 🏫 Multi-Grade Support: Content for different grade levels
• 🇮🇳 Cultural Context: Hindi & English with local examples
• 💡 Resource-Conscious: Designed for minimal resource environments

• Node.js 16+ installed
• Google Gemini API key (Get free key)

# Clone the repository
git clone https://github.com/yourusername/sahayak-app.git
cd sahayak-app

# Install dependencies
npm install

# Configure environment variables
cp .env.example .env
# Edit .env and add your Gemini API key

# Start development server
npm run dev

Create a .env file in the root directory:

# Google Gemini API Key
VITE_GEMINI_API_KEY=your_actual_gemini_api_key_here

Transform any textbook into interactive content:

1. Upload textbook photos via camera or file upload
2. AI analyzes the content using Google Gemini Vision
3. Generates educational materials:
   • 📝 Comprehension questions
   • 📋 Practice worksheets
   • 📚 Story adaptations
   • 🎯 Lesson plans

Choose from 25+ Gemini models including:

• 🆕 Gemini 2.5 Flash (FREE - Newest & Fastest)
• 🧠 Gemini 2.5 Pro (PAID - Most Advanced)
• ⚡ Gemini 2.0 Flash Experimental (FREE - Latest Features)
• 🔬 Multiple specialized models for different use cases

Frontend	AI/ML	Development	Deployment

• Frontend: React 19 + Vite for fast development
• Styling: CSS-in-JS with responsive design system
• Animations: Framer Motion for smooth interactions
• AI Integration: Google Gemini API with vision capabilities
• Icons: Lucide React for consistent iconography
• PDF Generation: jsPDF for downloadable content

sahayak-app/
├── 📁 public/                 # Static assets
│   ├── 🎨 sahayak-icon.svg   # App icon
│   └── 🔗 favicon.ico        # Browser favicon
├── 📁 src/
│   ├── 📁 components/         # React components
│   │   ├── 🎨 CameraTools.jsx      # Image analysis
│   │   ├── 📝 ContentGenerator.jsx # Story creation
│   │   ├── 📄 WorksheetGenerator.jsx # Worksheet tools
│   │   ├── 🧠 KnowledgeBase.jsx    # Q&A assistant
│   │   ├── 🎨 VisualAidGenerator.jsx # Drawing guide
│   │   ├── 🎤 AudioTools.jsx       # Voice features
│   │   ├── 📅 LessonPlanner.jsx    # Lesson planning
│   │   ├── 🎮 InteractiveGames.jsx # Educational games
│   │   └── ⚙️ ApiKeyModal.jsx      # Configuration
│   ├── 📁 hooks/              # Custom React hooks
│   │   ├── 🔑 useApiKey.js         # API key management
│   │   └── 🤖 useGeminiAI.js       # AI integration
│   ├── 📁 utils/              # Utility functions
│   │   ├── 📄 pdfGenerator.js      # PDF creation
│   │   ├── ⚠️ errorHandler.js      # Error management
│   │   └── ⚡ performance.js       # Optimization
│   ├── 🎨 App.jsx             # Main application
│   ├── 🎨 index.css           # Global styles
│   └── ⚡ main.jsx            # Entry point
├── 🔧 package.json            # Dependencies
├── ⚙️ vite.config.js          # Build configuration
├── 🌍 .env                    # Environment variables
└── 📖 README.md               # This file

1. Build the project

   npm run build

2. Deploy to Firebase

   • Go to Firebase Console
   • Create new project: "sahayak-app"
   • Enable Hosting
   • Upload files from dist folder

3. Your app is live!

   • URL: https://sahayak-app.web.app

npm i -g vercel
vercel

// 1. Generate educational story
const story = await generateContent('content', {
  topic: 'Friendship',
  gradeLevel: '5',
  language: 'Hindi'
});

// 2. Create worksheet from textbook photo
const worksheet = await analyzeImage(textbookPhoto, 'questions');

// 3. Plan comprehensive lesson
const lessonPlan = await createLesson({
  subject: 'Mathematics',
  topic: 'Fractions',
  duration: '45 minutes'
});

// Custom hook usage
const { callGeminiOptimized, loading } = useGeminiAI(genAI, selectedModel);

// Generate content with image
const result = await callGeminiOptimized(prompt, imageData);

# Required
VITE_GEMINI_API_KEY=your_api_key_here

# Optional (for advanced configuration)
VITE_APP_NAME=Sahayak
VITE_APP_VERSION=1.0.0

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature

3. Make your changes
4. Test thoroughly

   npm run dev
   npm run build

5. Submit a pull request

• 📝 Follow existing code style
• ✅ Add tests for new features
• 📖 Update documentation
• 🐛 Fix bugs with test cases
• 🎨 Maintain responsive design

• ⚡ Fast Loading: Optimized bundle with code splitting
• 📱 Mobile Optimized: 90+ Lighthouse score
• 🌐 Offline Ready: Service worker for caching
• 🔄 Real-time: Instant AI responses

• 🔐 API Key Protection: Client-side validation
• 🛡️ Input Sanitization: XSS prevention
• 🔒 HTTPS Only: Secure connections
• 🚫 No Data Storage: Privacy-first approach

• 🌍 Offline Mode: Complete offline functionality
• 🎯 Assessment Tools: Student progress tracking
• 🤝 Collaboration: Teacher-to-teacher sharing
• 📊 Analytics: Usage insights and reporting
• 🎨 Themes: Customizable UI themes
• 🌐 More Languages: Regional language support

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

• 🎓 Built for rural teachers and students
• 🤖 Powered by Google Gemini AI
• 🌍 Designed with accessibility and inclusivity
• ❤️ Made with love for education