ilyasmut/student-bluebook repository overview

⁠Blue Book

Blue Book is a web application that generates AI-powered multiple-choice questions for any exam or certification. It ships with a built-in preset for CompTIA Security+, but you can add any exam you need via the Exam Constructor. Powered by Google's Gemini API, it provides instant feedback, detailed explanations, and personalized study recommendations.

Project's Homepage⁠

⁠Features

⁠Question Generation & Review

• Generate multiple-choice questions for any exam using Gemini AI.
• Focus generation on specific topics or objectives with additional requests.
• Submit answers and receive immediate feedback with detailed explanations per choice.
• Get personalized study recommendations based on your answers.

⁠Exam Management

• Ships with a built-in CompTIA Security+ preset.
• Add custom exams for any certification or subject using the Exam Constructor.
• Seamlessly switch between exams — each exam maintains its own isolated state.

⁠Custom Prompts

• Build and manage custom prompt templates via the Prompt Builder.
• Use anchor-based templates to control exactly how questions are generated.
• Select from your saved prompts when generating questions.

⁠File Attachments

• Upload reference files (study guides, notes, etc.) to a local cache.
• Sync files to Gemini remote storage for AI-powered context.
• Attach specific files to exams — attached files are included as context during question generation.

⁠Persistence & State

• SQLite database stores all saved questions, topics, exams and prompts.
• Server-side sessions ensure state is preserved without cookie size limits.
• Save individual questions for later revision.
• Save and reuse custom topics per exam.
• State is automatically saved and restored when switching between exams.

⁠Tech Stack

⁠Installation

⁠Docker (recommended)

Run with a pre-built image:

docker run -d -p 5000:5000 --platform linux/amd64 ilyasmut/student-bluebook

Or build from source with Docker Compose:

git clone https://github.com/ilya-smut/blue-book
cd blue-book/
docker compose up -d

⁠pip / pipx

pip install student-bluebook

pipx install student-bluebook

⁠Usage

Start the application:

bluebook start

Start in debug mode (verbose logging):

bluebook start --debug

The app will be available at http://localhost:5000⁠. On first launch, you'll be prompted to enter your Gemini API key⁠.

For a full walkthrough of the interface, see the wiki⁠.

⁠Disclaimer

Blue Book is an independent study tool and is not affiliated with, endorsed by, or sponsored by CompTIA or any other certification body. All certification names are trademarks of their respective owners. You can purchase official CompTIA study materials at their official website⁠.

All questions are generated by third-party AI models (Google Gemini). The author of this application has no control over how these models were trained or what content they produce. Generated questions are intended as study aids and should not be treated as official exam material.

Please don't sue me.

⁠Contributing

If you'd like to contribute to Blue Book, feel free to submit a pull request or open an issue.

⁠License

This project is licensed under the GPLv3.

⁠Contact

For any questions or feedback, feel free to reach out.