https://github.com/dkoh2018/acegpt-generatepracticeexams

An AI-powered tool for generating custom practice exams. Input study guides, upload files, or create questions with adjustable difficulty levels. Built with Next.js and OpenAI API
https://github.com/dkoh2018/acegpt-generatepracticeexams

ai edtech exam-preparation nextjs openai-api react study-tool test-taking-platform

Last synced: 4 months ago
JSON representation

An AI-powered tool for generating custom practice exams. Input study guides, upload files, or create questions with adjustable difficulty levels. Built with Next.js and OpenAI API

• Host: GitHub
• URL: https://github.com/dkoh2018/acegpt-generatepracticeexams
• Owner: dkoh2018
• License: gpl-3.0
• Created: 2024-07-01T06:11:11.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-05T00:01:59.000Z (4 months ago)
• Last Synced: 2025-06-05T04:35:36.531Z (4 months ago)
• Topics: ai, edtech, exam-preparation, nextjs, openai-api, react, study-tool, test-taking-platform
• Language: TypeScript
• Homepage:
• Size: 463 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# AceGPT: Custom Practice Test Generator

Welcome to AceGPT, a powerful and intuitive tool designed to help you create personalized practice tests quickly and efficiently. Empower your exam preparation by generating tailored assessments from your study materials.

## About AceGPT

AceGPT was developed to streamline the exam preparation process. As a foundational project, it also served as an exploration into software architecture and the intricacies of application data flow, from user interface to backend processing. It allows users to leverage their own study guides, upload relevant files, or manually input questions to generate comprehensive practice exams. With features to control difficulty levels and access detailed solutions, AceGPT aims to be an indispensable companion for academic success.

## Key Features

*   **Flexible Input Methods:**

    *   Paste text directly from your study guides.

    *   Upload documents (e.g., PDFs, DOCX - specify supported formats if known).

    *   Manually create and input your own questions.

*   **Customizable Difficulty:** Tailor the difficulty of generated questions to match your learning curve.

*   **Detailed Solutions:** Receive comprehensive solutions and explanations for each question to deepen your understanding.

*   **Instant Test Generation:** Quickly produce practice tests with a few simple clicks.

## Getting Started

1.  **API Key Configuration:** Enter your OpenAI API key.

2.  **Model Selection:** Choose your preferred OpenAI model for test generation.

3.  **Content Input:** Provide your questions or study material through one of the supported input methods.

4.  **Generate:** Click the "Generate" button.

Your custom practice test will be ready, helping you to effectively prepare and ace your exams!

## Technology Stack

AceGPT is built using a modern technology stack to ensure a robust and user-friendly experience:

### Frontend

*   React

*   Next.js (also used for backend capabilities)

*   Radix UI

*   Zod (for schema validation)

*   React Hook Form

*   Material-UI

*   Lucide Icons

*   React Hot Toast (for notifications)

*   jsPDF (for PDF generation/export, if applicable)

### Backend & Core Logic

*   Next.js API Routes

*   OpenAI API Integration

*   Node.js (for server-side operations)

    *   `fs` (File System module)

    *   `path` (Path module)

## Contact

Created by David O. For inquiries, suggestions, or support, please feel free to reach out via email: `davidoh [at] gmail [dot] com`.