I created this project because I'm studying for my CCNA certification and needed a free, powerful way to create and study flashcards. This application is the result of that effort. It uses AI to automatically convert raw study notes into a structured, interactive deck of flashcards, making study sessions more efficient and effective.
I hope it can help you on your learning journey as much as it's helping me on mine!
- AI-Powered Formatting: Paste in your notes or upload a text/markdown file, and the app uses a GPT model to format them into a Q&A format.
- Interactive Study Sessions: Flip cards to reveal answers, and rate your confidence with "I knew it" or "Didn't know."
- Adaptive Learning: Questions you don't know are recycled back into the deck for you to try again.
- Performance Tracking: At the end of each session, view your accuracy and a running history of your performance over multiple attempts.
- Modern UI: A clean, beautiful interface with smooth 3D animations.
- Node.js (which includes npm) installed on your system.
- An API key from a GPT provider. Note: Currently, the application is configured to use the OpenAI API (
gpt-3.5-turbo). Support for other models can be added in the future.
-
Clone the Repository:
git clone https://github.com/JamesBratton-Codes/FlashCards.git cd FlashCards -
Install Dependencies: This will install all the necessary packages for the application.
npm install
-
Run the Application: You can run the app in two ways:
A) For Development: This command starts the app in development mode with live reloading. Ideal for making code changes.
npm start
B) As a Packaged App (Recommended for normal use): This command builds the app into a highly optimized, static set of files and serves it. This is the best way to run it for studying.
npm run serve
-
Open in Browser: Once running, the app will be available at
http://localhost:3000(forserve) or another port specified in the terminal.
- Enter your GPT API key. The app will save it in your browser's local storage so you don't have to enter it every time.
- Paste your notes into the text area or upload a
.mdor.txtfile. - Click "Run".
- The AI will format your notes into flashcards, and your study session will begin!