---
title: README
emoji: 📊
colorFrom: blue
colorTo: pink
sdk: static
pinned: false
---

<p align="center">
  <img src="https://raw.githubusercontent.com/asahi417/lm-question-generation/master/assets/qg_diagram.png" width="500">
</p>

<br>

***Language Models for Question Generation (LMQG)*** is the official registry of <a href="paper_link">"Generative Language Models for Paragraph-Level Question Generation, EMNLP 2022"</a>, which has proposed <a href="https://github.com/asahi417/lm-question-generation/blob/master/QG_BENCH.md">QG-Bench</a>, multilingual and multidomain question generation datasets and models.
See our <a href="https://github.com/asahi417/lm-question-generation">GitHub</a> for more information.

Basic usage of our QG model follows below.
<pre class="line-numbers">
   <code class="language-python">
      pip install lmqg
   </code>
</pre>

<pre class="line-numbers">
   <code class="language-python">
   from lmqg import TransformersQG
   model = TransformersQG(language='en', model='lmqg/t5-large-squad-multitask')
   context = "William Turner was an English painter who specialised in watercolour landscapes. "
             "He is often known as William Turner of Oxford or just Turner of Oxford to "
             "distinguish him from his contemporary, J. M. W. Turner. Many of Turner's "
             "paintings depicted the countryside around Oxford. One of his best known "
             "pictures is a view of the city of Oxford from Hinksey Hill."
   question_answer = model.generate_qa(context)
   print(question_answer)
   [
       ('Who was an English painter who specialised in watercolour landscapes?', 'William Turner'),
       ("What was William Turner's nickname?", 'William Turner of Oxford'),
       ("What did many of Turner's paintings depict around Oxford?", 'countryside'),
       ("What is one of William Turner's best known paintings?", 'a view of the city of Oxford')
   ]
   </code>
</pre>