zjuhechao/exam-porridge-assistant

Exam Porridge Assistant is a study and exam preparation tool that runs locally in your browser. You upload learning materials such as PDFs, Word documents, text files, or images, and it uses an AI language model to generate review outlines, study notes, and practice questions from the content. Practice questions can be multiple choice, fill-in-the-blank, true or false, or short answer. The README is written in Chinese and the tool appears to target Chinese-language learners and students. The tool also includes a drill mode where you work through a question set and have wrong answers tracked automatically. Those tracked errors feed into targeted follow-up practice, so you spend more time on material you got wrong. Study data is organized by course and stored entirely in your browser's local storage, with nothing sent to any external server. Clearing your browser data would delete all stored records. To use the AI features, you supply your own API key from a supported provider, such as DeepSeek, Alibaba's Tongyi Qianwen, or OpenAI. The application calls that API directly from your browser on demand. OCR (converting images of text into editable text) requires a key from a provider whose model supports image input. The README walks through getting a DeepSeek key as the primary example. The application is built with TypeScript, React 18, and Tailwind CSS. Local data is stored using IndexedDB through a library called Dexie. It runs on a local development server you start with a Node.js command and then access in your browser at a local address. The README includes detailed setup instructions aimed at users with no prior coding experience, covering Windows, macOS, and Linux.