StanleyKioko/Impact-Africa-Hack

# Smart Education Bot An AI-powered educational assistant designed to enhance learning experiences in rural schools by providing accessible educational resources and support in multiple languages. ## Features - AI-powered question answering using LLaMA 2 model - Multi-language support (English and Swahili) - Web-based user interface - Real-time response generation - Educational resource recommendations - Integration with Groq hardware for optimized performance ## Tech Stack - Backend: - Python - FastAPI - Transformers/PyTorch - LLaMA 2 Model - Translation Services - Frontend: - React - Streamlit (Alternative UI) - Material UI - RESTful API Integration ## Getting Started ### Prerequisites - Python 3.8+ - Node.js 14+ - pip - npm/yarn ### Installation 1. Clone the repository: ```bash git clone github.com cd smart-education-bot ``` 2. Set up the Python environment: ```bash python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate python setup.py ``` 3. Start the backend server: ```bash cd backend uvicorn app:app --reload ``` 4. Start the frontend development server: ```bash cd frontend npm install npm start ``` The application will be available at: - Backend API: localhost - Frontend: localhost - API Documentation: localhost ## Project Structure ``` smart-education-bot/ ├── backend/ │ ├── app.py # FastAPI application │ ├── models/ │ │ ├── llama2_model.py # LLaMA 2 model implementation │ │ └── mistral7b_model.py # Alternative model │ ├── routes/ │ │ └── api.py # API endpoints │ ├── services/ │ │ └── translator.py # Translation service │ └── utils/ │ └── state.py # Application state management ├── frontend/ │ ├── src/ │ │ ├── components/ # React components │ │ ├── pages/ # Page components │ │ └── styles/ # CSS styles │ └── app.py …