CODEHOUSE QUIZ SUITE (cdquiz)

AI-powered CLI learning system for Programming Languages such as Python, Java, JavaScript, HTML, Artificial Intelligence, Machine Learning, Data Science, Cybersecurity, and more.

---

Overview

cdquiz is a terminal-based interactive learning platform built by Applinet Technology under the CodeHouse Cloud Initiative.

It transforms your terminal into a smart classroom where users can:

• Learn interactively
• Practice real technical skills
• Earn QuizCoins
• Track learning progress
• Compete globally
• Receive AI-powered explanations

---

Features

CodeHouse Quiz Suite provides a modern learning experience directly from the command line.

Features include:

• AI-powered answer explanations
• QuizCoin reward system
• Smart scoring and ranking engine
• Global leaderboard system
• Fast and lightweight CLI experience
• Secure quiz sessions
• Real-time progress tracking
• Resume unfinished quizzes
• Multi-category learning structure
• Anti-cheat and secure validation system

---

Learning Categories

Programming

Supported and expanding areas include:

• Python
• Java
• JavaScript
• HTML
• Django
• Flask
• APIs
• Backend Development
• Additional programming technologies

Artificial Intelligence

• Artificial Intelligence
• Machine Learning
• Data Science

Security

• Cybersecurity
• Ethical Hacking Basics
• Security Fundamentals

Additional categories continue to grow as the platform evolves.

---

AI Learning Engine

The built-in AI engine improves learning through:

• Intelligent answer explanations
• Learning guidance
• Performance feedback
• Motivation system
• Smart progress analysis

The goal is not simply to test knowledge but to help learners understand concepts more effectively.

---

QuizCoin Economy

CodeHouse Quiz Suite includes a reward-based learning economy.

Users can earn QuizCoins while learning and participating in quizzes.

QuizCoin features include:

• Wallet system
• QuizCoin tracking
• Reward-based engagement
• Learning incentives

---

Smart Progress Tracking

Track performance in real time.

Metrics include:

• Accuracy
• Quiz score
• Completion rate
• Rank
• Speed
• Remaining attempts

This allows learners to monitor improvement and identify growth areas.

---

Leaderboards

Compete globally with learners around the world.

Leaderboard system includes:

• Global ranking
• Course ranking
• Score tracking
• Performance comparison

The leaderboard creates healthy competition and encourages consistent improvement.

---

Screenshots

Welcome Dashboard

Quiz Interface

Wallet System

---

Installation

Install directly from PyPI:

pip install cdquiz

---

Run Application

Launch the application using:

python -m cdquiz.start

or simply:

cdquiz

---

Upgrade

Upgrade to the latest version:

pip install --upgrade cdquiz

---

Example Dashboard

CDQuiz Dashboard

1. Start / Resume Quiz
2. View Leaderboard
3. Announcements
4. ...

---

Quiz Flow

The learning structure follows a guided hierarchy:

Category
   ↓
SubCategory
   ↓
Course
   ↓
Questions

Example:

Python
   ↓
Django
   ↓
Authentication
   ↓
Quiz Questions

This structure helps learners move from broader concepts into specialized learning paths.

---

Example Quiz Session

Question 3 of 10

What keyword is used to define a Python function?

1. function
2. define
3. def
4. func

Your answer: 3

---

Example Performance Feedback

Correct!

Progress: 5/20
Score: 85%
Rank: #7

---

Security Features

CodeHouse Quiz Suite includes multiple layers of quiz protection and validation.

Security mechanisms include:

• Active session validation
• Request verification
• Quiz tampering protection
• Question overflow protection
• Secure quiz access control
• Attempt limitation system

These protections help ensure fair participation and secure quiz delivery.

---

Technologies Used

Backend

• Python
• Django
• Django REST Framework

CLI

• Rich
• Prompt Toolkit
• Requests

Database

• PostgreSQL
• SQLite

---

Vision

CodeHouse Quiz Suite is designed to empower developers and digital learners across the globe through:

• AI-enhanced education
• Practical technical learning
• Gamification
• Reward systems
• Real-world developer training

The platform aims to make technical education more accessible, engaging, and skill-oriented.

---

About Applinet Technology

Applinet Technology is an African-centered technology company that combines innovation, modern technology, and African values to build impactful digital solutions.

Through initiatives like CodeHouse Cloud, the company focuses on solving real problems through technology, education, and digital empowerment.

---

Author

Godswill Moses Ikpotokin
Founder & CEO — Applinet Technology

---

License

This project is released under the MIT License.

---

Contributing

Contributions are welcome.

You can contribute by:

• Reporting bugs
• Suggesting new features
• Improving documentation
• Submitting pull requests

Community contributions help improve the ecosystem for everyone.

---

Support

For support, partnerships, or collaborations:

Email: genius@codehouse.cloud

---

CodeHouse Quiz Suite is more than a quiz platform.

It is a developer growth ecosystem designed to help learners gain practical technical skills directly from the terminal through interactive learning, AI guidance, competition, and rewards.