mcqgen

使用 LangChain 和 HuggingFace Hub API 的 MCQ 生成器应用程序

MCQ Generator with Streamlit 是一款 Web 应用程序，允许用户上传 PDF 或文本文件，指定问题数量、主题和语气，并根据提供的输入生成多项选择题 (MCQ)。该应用程序利用 Hugging Face API 开源语言模型进行自然语言处理，并提供有关生成测验的复杂性的反馈。

要运行此应用程序：

• 下载此存储库并使用命令 pip install -rrequirements.txt 安装必备库
• 运行命令streamlit runstreamlitapp.py来运行该应用程序。
• PS：您需要在 mcqGen.py 文件中提供您自己的 HUGGING_FACE_TOKEN。

特征

• 文件上传：用户可以上传包含用于生成 MCQ 的文本的 PDF 或文本文件。
• 动态输入：用户可以指定生成的 MCQ 的问题数量、主题和语气。
• 实时反馈：提供有关生成的测验复杂性的实时反馈并提出改进建议。
• 表格显示：以表格格式显示生成的 MCQ，以便于阅读。

先决条件

• Python 3.x
• Streamlit图书馆
• 朗链图书馆
• HUGGING_FACE_TOKEN

安装

1. 克隆存储库：

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

2 安装所需的依赖项：

pip install -r requirements.txt

3. 设置环境变量：

   • 在根目录中创建一个 .env 文件。

   • 将您的 OpenAI API 密钥添加到 .env 文件中：

     HF_API_TOKEN=YOUR_TOKEN_HERE

4. 在虚拟环境中安装本地包：

   python setup.py install

演示

即将推出...

用法

1. 运行 Streamlit 应用程序：

   streamlit run main.py

2. 在网络浏览器中访问该应用程序。

3. 上传 PDF 或文本文件，指定问题数量、主题和语气，然后单击“创建 MCQ”按钮。

4. 查看生成的 MCQ 和提供的审核反馈。

记录

• 所有日志都存储在logs目录中。
• 每个日志文件都以时间戳命名，指示其创建时间。