Skip to content

Blue Book is an application that generates multiple-choice preparation questions for IT certifications, e.g. CompTIA A+, Network+, and Security+.

License

Notifications You must be signed in to change notification settings

ilya-smut/blue-book

Repository files navigation

Bluebook Logo

Blue Book

demo-gif

Blue Book is an application that generates multiple-choice questions for IT certifications, e.g. CompTIA A+, Network+, and Security+. It uses the Gemini API to generate questions and provides instant feedback on answers.

Project's Homepage

Features

  • Generate multiple-choice questions for any IT certifications, including CompTIA A+, Network+, and Security+. Add more certifications using Exam Constructor
  • Easily switch between preset exams or add your own custom certifications.
  • Focus question generation on specific topics or objectives.
  • Save and access custom topics for future use, per certification.
  • Submit answers and receive immediate feedback with detailed explanations.
  • Get personalized study recommendations based on your answers.
  • Save individual questions for later revision.
  • Persistent state: all saved questions and topics are retained across sessions.
  • Isolated storage per certification ensures organized progress tracking.
  • Run the app in a Docker container with a single command and minimal setup.

Switching between certifications

Easily switch between built-in certifications.

switching-exam

Add more certifications with Exam Constructor

Use Exam constructor to add more certifications to the list.

exam-constructor

All certs have their own state

All exams have their own space for saved topics and saved questions.

isolated-exams

Installation

You can install bluebook with pip:

pip install student-bluebook

With pipx

pipx install student-bluebook

Or you can simply run it in a docker container

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

or

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

Usage

Please see bluebook's interface and capabilities on this wiki page wiki page:

To start the application, use the following command:

bluebook start

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.

About

Blue Book is an application that generates multiple-choice preparation questions for IT certifications, e.g. CompTIA A+, Network+, and Security+.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published