https://github.com/akdevv/ai-qna
A quiz application powered by Groq's API
https://github.com/akdevv/ai-qna
Last synced: 12 months ago
JSON representation
A quiz application powered by Groq's API
- Host: GitHub
- URL: https://github.com/akdevv/ai-qna
- Owner: akdevv
- License: mit
- Created: 2025-04-26T04:44:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-26T16:48:28.000Z (about 1 year ago)
- Last Synced: 2025-06-08T12:43:07.700Z (about 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 118 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI Quiz App
A modern quiz application powered by Groq's AI model that generates questions based on user-selected topics and difficulty levels. Users can choose from various topics like science, technology, history, Marvel, Harry Potter, and more.
## Features
- Dynamic quiz generation using Groq's AI model
- Multiple topic selection
- Adjustable difficulty levels
- Real-time question generation
- Modern and responsive UI
## Tools and Technologies
- **Framework**: Next.js
- **Language**: TypeScript
- **Package Manager**: pnpm
- **UI Components**: Shadcn
- **Styling**: Tailwind CSS
- **AI Model**: Groq (gemma2-9b-it)
## Getting Started
### Prerequisites
- Node.js (latest LTS version recommended)
- pnpm package manager
- Groq API key
### Local Development
1. Clone the repository:
```bash
git clone
```
2. Install dependencies:
```bash
pnpm install
```
3. Create a Groq account and get your API key:
- Visit [Groq](https://groq.com/)
- Sign up for an account
- Get your API key from the dashboard
4. Create a `.env.local` file in the root directory and add your API key:
```bash
GROQ_API_KEY=
```
5. Run the development server:
```bash
pnpm dev
```
6. Open [http://localhost:3000](http://localhost:3000) with your browser to see the application.
## Project Structure
The project uses Next.js App Router and follows the standard Next.js project structure. The main application code is in the `app` directory.
## Learn More
To learn more about the technologies used in this project:
- [Next.js Documentation](https://nextjs.org/docs)
- [TypeScript Documentation](https://www.typescriptlang.org/docs/)
- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
- [Shadcn UI Documentation](https://ui.shadcn.com/)
- [Groq Documentation](https://groq.com/)
## License
This project is licensed under the MIT License.