{"id":20961470,"url":"https://github.com/jittojoseph/quizmaster","last_synced_at":"2026-05-07T09:33:07.878Z","repository":{"id":261037509,"uuid":"883064156","full_name":"JittoJoseph/QuizMaster","owner":"JittoJoseph","description":"Master Any Topic with Lightning-Fast AI Quizzes, Powered by SambaNova's LLaMA Model Access","archived":false,"fork":false,"pushed_at":"2024-11-20T06:49:27.000Z","size":283,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-20T00:48:23.883Z","etag":null,"topics":["hackathon","javascript","llama3","react","sambanova"],"latest_commit_sha":null,"homepage":"https://quizmaster-pro.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JittoJoseph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-04T10:11:15.000Z","updated_at":"2024-11-26T14:10:07.000Z","dependencies_parsed_at":"2024-11-16T06:26:16.168Z","dependency_job_id":"2696d88e-d7b5-46ab-a133-3d3e39a549d1","html_url":"https://github.com/JittoJoseph/QuizMaster","commit_stats":null,"previous_names":["jittojoseph/quizmaster-sambanovaapi","jittojoseph/quizmaster"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JittoJoseph%2FQuizMaster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JittoJoseph%2FQuizMaster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JittoJoseph%2FQuizMaster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JittoJoseph%2FQuizMaster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JittoJoseph","download_url":"https://codeload.github.com/JittoJoseph/QuizMaster/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243358307,"owners_count":20277995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hackathon","javascript","llama3","react","sambanova"],"created_at":"2024-11-19T02:13:50.002Z","updated_at":"2025-10-30T21:40:46.511Z","avatar_url":"https://github.com/JittoJoseph.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QuizMaster 🎯\n\n**QuizMaster** is an AI-powered quiz generation platform that creates personalized learning experiences using Meta's LLaMA 3.1 70B model through SambaNova's API. Generate custom quizzes on any topic instantly, tailored to your selected difficulty level, and track your learning progress with ease.\n\n## Features\n\n- **User-Defined Topics**: Enter any topic you desire, and the AI will generate a unique quiz tailored to that subject.\n- **Multiple Difficulty Levels**: Choose between Beginner, Intermediate, and Advanced levels.\n- **Real-Time Question Generation**: Leverages SambaNova's API to interact with Meta's LLaMA 3.1 model, generating multiple-choice questions on the fly.\n- **Immediate Feedback**: Receive instant responses to your answers for an engaging learning experience.\n- **Progress Tracking**: Monitor your learning journey with detailed statistics and performance analytics.\n- **User Profiles**: Save quiz history and revisit past quizzes.\n- **Responsive Design**: Enjoy a seamless experience across all devices.\n\n## Tech Stack\n\n- **Frontend**:\n  - React 18\n  - Vite\n  - Tailwind CSS\n- **Backend Services**:\n  - Firebase Authentication\n  - Firebase Firestore\n- **AI Integration**:\n  - SambaNova API (Meta LLaMA 3.1)\n- **Deployment**:\n  - Vercel (Edge Runtime)\n\n## Prerequisites\n\n- **Node.js** version 16 or higher installed on your machine.\n- **Firebase Account** for authentication and database services.\n- **SambaNova API Access** to utilize the AI model (Meta's LLaMA 3.1).\n\n## Setup Instructions\n\n### 1. Clone the Repository\n\nClone the repository to your local machine using:\n\n```bash\ngit clone https://github.com/JittoJoseph/QuizMaster.git\ncd QuizMaster\n```\n\n### 2. Install Dependencies\n\nInstall the required dependencies using npm:\n\n```bash\nnpm install\n```\n\n### 3. Firebase Setup\n\n**a. Create a Firebase Project**\n\n- Go to the [Firebase Console](https://console.firebase.google.com).\n- Click **Add project** and follow the prompts to create a new project.\n\n**b. Enable Authentication**\n\n- In your Firebase project, navigate to **Authentication** \u003e **Sign-in method**.\n- Enable **Google Sign-in** under **Sign-in providers**.\n\n**c. Create Firestore Database**\n\n- Navigate to **Firestore Database** in the Firebase console.\n- Click **Create database** and select **Start in test mode** (ensure appropriate security rules for production).\n\n**d. Register a Web App and Obtain Config**\n\n- Go to **Project settings** (the gear icon).\n- In the **General** tab, scroll down to **Your apps**.\n- Click on the **\u003c/\u003e** icon to add a web app.\n- Register the app (you can name it \"QuizMaster\") and click **Register app**.\n- Copy the provided Firebase configuration (you'll need this in the next step).\n\n### 4. SambaNova API Setup\n\nEnsure you have access to the SambaNova API to utilize Meta's LLaMA 3.1 model. Obtain your `SAMBANOVA_API_KEY` from your SambaNova account.\n\n### 5. Environment Setup\n\nCreate a .env file in the root directory of your project and add the following environment variables:\n\n```env\n# .env\nVITE_FIREBASE_API_KEY=your_firebase_api_key\nVITE_FIREBASE_AUTH_DOMAIN=your_project_id.firebaseapp.com\nVITE_FIREBASE_PROJECT_ID=your_project_id\nVITE_FIREBASE_STORAGE_BUCKET=your_project_id.appspot.com\nVITE_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id\nVITE_FIREBASE_APP_ID=your_app_id\nVITE_FIREBASE_MEASUREMENT_ID=your_measurement_id\nSAMBANOVA_API_KEY=your_sambanova_api_key\n```\n\n*Replace all placeholder values with the actual configuration details from your Firebase project and SambaNova account.*\n\n\n### 6. Start the Development Server\n\nRun the following command to start the development server:\n\n```bash\nnpm run dev\n```\n\nThe application should now be running on `http://localhost:3000/` (or the port specified in your terminal).\n\n## Deployment\n\n### 1. Push Code to GitHub\n\nCommit your changes and push the code to a GitHub repository.\n\n### 2. Deploy on Vercel\n\n**a. Sign Up or Log In**\n\n- Go to [Vercel](https://vercel.com) and sign up or log in with your GitHub account.\n\n**b. Import Your Repository**\n\n- Click on **New Project** and import your QuizMaster repository.\n\n**c. Configure Project Settings**\n\n- **Framework Preset**: Select **Vite**.\n- **Build Command**: `npm run build`\n- **Output Directory**: `dist`\n\n**d. Set Environment Variables**\n\n- In the **Environment Variables** section, add all the environment variables from your .env file.\n- Be sure to include `SAMBANOVA_API_KEY` and all the `VITE_FIREBASE_*` variables.\n\n**e. Deploy**\n\n- Click **Deploy** to start the deployment process.\n- Once deployed, your application will be available at the provided Vercel URL.\n\n## Important Notes\n\n- **Firebase Security Rules**: If you plan to use the application in production, update your Firebase Firestore security rules to restrict unauthorized access.\n- **SambaNova API Usage**: Be mindful of the usage limits and costs associated with the SambaNova API.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the LICENSE file for details.\n\n## Contact\n\nFor any inquiries or support, please contact:\n\n- **Jitto Joseph** - [@JittoJoseph50](https://twitter.com/JittoJoseph50)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjittojoseph%2Fquizmaster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjittojoseph%2Fquizmaster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjittojoseph%2Fquizmaster/lists"}