mcqgen

Application de génération de QCM utilisant LangChain et l'API HuggingFace Hub

MCQ Generator avec Streamlit est une application Web qui permet aux utilisateurs de télécharger des fichiers PDF ou texte, de spécifier le nombre de questions, le sujet et le ton, et de générer des questions à choix multiples (QCM) en fonction des entrées fournies. L'application utilise des modèles de langage open source de l'API Hugging Face pour le traitement du langage naturel et fournit des commentaires sur la complexité du quiz généré.

Pour exécuter cette application :

• Téléchargez ce dépôt et installez les bibliothèques prérequises à l'aide de la commande pip install -r Requirements.txt
• Exécutez la commande streamlit run streamlitapp.py pour exécuter l'application.
• PS : Vous devrez fournir votre propre HUGGING_FACE_TOKEN dans le fichier mcqGen.py.

Caractéristiques

• Téléchargement de fichiers : les utilisateurs peuvent télécharger des fichiers PDF ou texte contenant le texte à partir duquel les QCM seront générés.
• Entrées dynamiques : les utilisateurs peuvent spécifier le nombre de questions, le sujet et le ton des QCM générés.
• Commentaires en temps réel : fournit un retour en temps réel sur la complexité du quiz généré et suggère des améliorations.
• Affichage tabulaire : affiche les QCM générés sous forme de tableau pour une lisibilité facile.

Conditions préalables

• Python 3.x
• Bibliothèque rationalisée
• Bibliothèque Langchain
• HUGGING_FACE_TOKEN

Installation

1. Clonez le dépôt :

   git clone https://github.com/4darsh-Dev/mcqgen.git

2 Installez les dépendances requises :

pip install -r requirements.txt

3. Configurez les variables d'environnement :

   • Créez un fichier .env dans le répertoire racine.

   • Ajoutez votre clé API OpenAI au fichier .env :

     HF_API_TOKEN=YOUR_TOKEN_HERE

4. Installez le package local dans l'environnement virtuel :

   python setup.py install

Démo

À VENIR...

Usage

1. Exécutez l'application Streamlit :

   streamlit run main.py

2. Accédez à l'application dans votre navigateur Web.

3. Téléchargez un fichier PDF ou texte, spécifiez le nombre de questions, le sujet et le ton, puis cliquez sur le bouton « Créer des QCM ».

4. Consultez les QCM générés et les commentaires d'évaluation fournis.

Enregistrement

• Tous les journaux sont stockés dans le répertoire logs .
• Chaque fichier journal est nommé avec un horodatage indiquant la date à laquelle il a été créé.