Skip to content

muhammadtalhaamin/AI-Flash-card-generator

Repository files navigation

FlashCardGPT

An AI-powered application that creates customized flashcards based on any uploaded text file, making studying easier and more effective.

Table of Contents

Live Demo

https://ai-flash-card-generator-mauve.vercel.app/

Features

  • User-friendly access with gmail login or email/password authentication.
  • Generate flashcards by uploading text files.
  • Each flashcard contains AI-generated questions and answers for effective study.
  • Save, edit, and organize flashcards within custom folders.

Technologies Used

  • Next.js
  • React
  • OpenAI API Key
  • Clerk authentication

Getting Started

Prerequisites

  • Next.js
  • Clerk credentials
  • OpenAI API Key

How to run the project

  1. Clone the repository:

    git clone https://github.com/0xmetaschool/FlashCardGPT.git
  2. Navigate to the project directory:

    cd FlashCardGPT 
  3. Install dependencies:

    npm install
  4. Set up environment variables: Create a .env file in the root directory as .env.local with the following environment variables:

    NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
    CLERK_SECRET_KEY=
    
    NEXT_PUBLIC_CLERK_SIGN_IN_URL=
    NEXT_PUBLIC_CLERK_SIGN_UP_URL=
    
    OPENAI_API_KEY=
  5. Run the development server:

    npm run dev
  6. Run the development server:

Open the browser and go to http://localhost:3000. Ensure that everything is loading and the live preview works as expected.

Screenshots

Screenshot 1 Screenshot 2
Screenshot 3

How to use the application

  1. Sign-in using your Google account.
  2. Upload a document to generate flashcards.
  3. Click on any flashcard to view the answer.
  4. Review flashcards through the dashboard, and reuse as needed.

Contributing

We love contributions! Here's how you can help make the AI-powered FinanceGuru even better:

  1. Fork the project (gh repo fork https://github.com/0xmetaschool/FlashCardGPT.git)
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

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

Acknowledgments

  • OpenAI for powering the flashcard generation
  • Clerk for login and authentication

Contact

Please open an issue in the GitHub repository for any queries or support.

Releases

No releases published

Packages

No packages published