Package: lmqg
Question and Answer Generation with Language ModelsFigure 1: Three distinct QAG approaches.Thelmqgis a python library for question and answer generation (QAG) with language models (LMs). Here, we consider
paragraph-level QAG, where user will provide a context (paragraph or document), and the model will generate a list of
question and answer pairs on the context. Withlmqg, you can do following things:Generation in One Line of Code:Generate questions and answers in8languages (en/fr/ja/ko/ru/it/es/de).Model Training/Evaluation:Train & evaluate your own QG/QAG models.QAG & QG Model Hosting:Host your QAG models on a web application or a restAPI server.AutoQG:Online web service to generate questions and answers with our models.Update May 2023:Two papers got accepted by ACL 2023 (QAG at finding,LMQG at system demonstration).Update Oct 2022:OurQG papergot accepted by EMNLP main 2022.A bit more about QAG models 📝Our QAG models can be grouped into three types:Pipeline,Multitask,
andEnd2end(see Figure 1). ThePipelineconsists of question generation (QG) and answer extraction (AE) models independently,
where AE will parse all the sentences in the context to extract answers, and QG will generate questions on the answers.
TheMultitaskfollows same architecture as thePipeline, but the QG and AE models are shared model fine-tuned jointly.
Finally,End2endmodel will generate a list of question and answer pairs in an end-to-end manner.
In practice,PipelineandMultitaskgenerate more question and answer pairs, whileEnd2endgenerates less but a few times faster,
and the quality of the generated question and answer pairs depend on language.
All types are available in the8diverse languages (en/fr/ja/ko/ru/it/es/de) vialmqg, and the models are all shared on HuggingFace (see themodel card).
To know more about QAG, please checkour ACL 2023 paperthat describes the QAG models and reports a complete performance comparison of each QAG models in every language.Is QAG different from Question Generation (QG)? 🤔Figure 2: An example of QAG (a) and QG (b).All the functionalities support question generation as well. Our QG model assumes user to specify an answer in addition to a context,
and the QG model will generate a question that is answerable by the answer given the context (see Figure 2 for a comparison of QAG and QG).
To know more about QG, please checkour EMNLP 2022 paperthat describes the QG models more in detail.Get Started 🚀Let's installlmqgvia pip first.pipinstalllmqgGenerate Question & AnswerThe main functionality oflmqgis to generate question and answer pairs on a given context with a handy api.
The available models for each QAG class can be found atmodel card.QAG with End2end or Multitask Models:The end2end QAG models are fine-tuned to generate a list of QA pairs with a single inference,
so it is the fastest class among our QAG models. Meanwhile, multitask QAG models breakdown the QAG task into QG and AE, where they
parse each sentence to get the answer with AE, and generate question on each answer with QG. Multitask QAG potentially generate more QA pairs than end2end QAG, but
inference takes a few times more than end2end models. Both models can be used as followingfrompprintimportpprintfromlmqgimportTransformersQG# initialize modelmodel=TransformersQG('lmqg/t5-base-squad-qag')# or TransformersQG(model='lmqg/t5-base-squad-qg-ae')# paragraph to generate pairs of question and answercontext="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."# model predictionquestion_answer=model.generate_qa(context)# the output is a list of tuple (question, answer)pprint(question_answer)[('Who was an English painter who specialised in watercolour landscapes?','William Turner'),('What is William Turner often known as?','William Turner of Oxford or just Turner of Oxford'),("What did many of Turner's paintings depict?",'the countryside around Oxford'),("What is one of Turner's best known pictures?",'a view of the city of Oxford from Hinksey Hill')]QAG with Pipeline Models:The pipeline QAG is similar to multitask QAG, but the QG and AE models are independently fine-tuned, unlike
multitask QAG that fine-tunes QG and AE jointly. Pipeline QAG can improve the performance in some cases, but it is as heavy as multitask QAG with
more storage consuming due to the two models loaded. The pipeline QAG can be used as following. Themodelandmodel_aeare the QG and AE models respectively.frompprintimportpprintfromlmqgimportTransformersQG# initialize modelmodel=TransformersQG(model='lmqg/t5-base-squad-qg',model_ae='lmqg/t5-base-squad-ae')# paragraph to generate pairs of question and answercontext="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."# model predictionquestion_answer=model.generate_qa(context)# the output is a list of tuple (question, answer)pprint(question_answer)[('Who was an English painter who specialised in watercolour landscapes?','William Turner'),('What is another name for William Turner?','William Turner of Oxford'),("What did many of William Turner's paintings depict around Oxford?",'the countryside'),('From what hill is a view of the city of Oxford taken?','Hinksey Hill.')]QG only:The QG model can be used as following. Themodelis the QG model. See theQG-Bench,
a multilingual QG benchmark, for the list of available QG models.frompprintimportpprintfromlmqgimportTransformersQG# initialize modelmodel=TransformersQG(model='lmqg/t5-base-squad-qg')# a list of paragraphcontext=["William Turner was an English painter who specialised in watercolour landscapes","William Turner was an English painter who specialised in watercolour landscapes"]# a list of answer (same size as the context)answer=["William Turner","English"]# model predictionquestion=model.generate_q(list_context=context,list_answer=answer)pprint(question)['Who was an English painter who specialised in watercolour landscapes?','What nationality was William Turner?']AE only:The QG model can be used as following. Themodelis the QG model.frompprintimportpprintfromlmqgimportTransformersQG# initialize modelmodel=TransformersQG(model='lmqg/t5-base-squad-ae')# model predictionanswer=model.generate_a("William Turner was an English painter who specialised in watercolour landscapes")pprint(answer)['William Turner']AutoQGAutoQG (https://autoqg.net)is a free web application hosting our QAG models.Model DevelopmentThelmqgalso provides a command line interface to fine-tune and evaluate QG, AE, and QAG models.Model TrainingTo fine-tune QG (or AE, QAG) model, we employ a two-stage hyper-parameter optimization, described as above diagram.
Following command is to run the fine-tuning with parameter optimization.lmqg-train-search-c"tmp_ckpt"-d"lmqg/qg_squad"-m"t5-small"-b64--epoch-partial5-e15--language"en"--n-max-config1\-g24--lr1e-045e-041e-03--label-smoothing00.15Checklmqg-train-search -hto display all the options.Fine-tuning models in python follows below.fromlmqgimportGridSearchertrainer=GridSearcher(checkpoint_dir='tmp_ckpt',dataset_path='lmqg/qg_squad',model='t5-small',epoch=15,epoch_partial=5,batch=64,n_max_config=5,gradient_accumulation_steps=[2,4],lr=[1e-04,5e-04,1e-03],label_smoothing=[0,0.15])trainer.run()Model EvaluationThe evaluation tool reportsBLEU4,ROUGE-L,METEOR,BERTScore, andMoverScorefollowingQG-Bench.
From command line, run following commandlmqg-eval-m"lmqg/t5-large-squad-qg"-e"./eval_metrics"-d"lmqg/qg_squad"-l"en"where-mis a model alias on huggingface or path to local checkpoint,-eis the directly to export the metric file,-dis the dataset to evaluate, and-lis the language of the test set.
Instead of running model prediction, you can provide a prediction file instead to avoid computing it each time.lmqg-eval--hyp-test'{your prediction file}'-e"./eval_metrics"-d"lmqg/qg_squad"-l"en"The prediction file should be a text file of model generation in each line in the order oftestsplit in the target dataset
(sample).
Checklmqg-eval -hto display all the options.Rest API with huggingface inference APIFinally,lmqgprovides a rest API which hosts the model inference through huggingface inference API. You need huggingface API token to run your own API and install dependencies as below.pipinstalllmqg[api]Swagger UI is available athttp://127.0.0.1:8088/docs, when you run the app locally (replace the address by your server address).BuildBuild/Run Local (command line):exportAPI_TOKEN={YourHuggingfaceAPIToken}uvicornapp:app--reload--port8088uvicornapp:app--host0.0.0.0--port8088Build/Run Local (docker):dockerbuild-tlmqg/app:latest.--build-argapi_token={YourHuggingfaceAPIToken}dockerrun-p8080:8080lmqg/app:latestAPI DescriptionYou must pass the huggingface api token via the environmental variableAPI_TOKEN.
The main endpoint isquestion_generation, which has following parameters,ParameterDescriptioninput_textinput text, a paragraph or a sentence to generate questionlanguagelanguageqg_modelquestion generation modelanswer_modelanswer extraction modeland return a list of dictionaries withquestionandanswer.{"qa":[{"question":"Who founded Nintendo Karuta?","answer":"Fusajiro Yamauchi"},{"question":"When did Nintendo distribute its first video game console, the Color TV-Game?","answer":"1977"}]}CitationPlease cite following paper if you use any resource and see the code to reproduce the model if needed.Generative Language Models for Paragraph-Level Question Generation, EMNLP 2022 Main: The QG models (code to reproduce experiments).@inproceedings{ushio-etal-2022-generative,
    title = "{G}enerative {L}anguage {M}odels for {P}aragraph-{L}evel {Q}uestion {G}eneration",
    author = "Ushio, Asahi  and
        Alva-Manchego, Fernando  and
        Camacho-Collados, Jose",
    booktitle = "Proceedings of the 2022 Conference on Empirical Methods in Natural Language Processing",
    month = dec,
    year = "2022",
    address = "Abu Dhabi, U.A.E.",
    publisher = "Association for Computational Linguistics",
}An Empirical Comparison of LM-based Question and Answer Generation Methods, ACL 2023, Finding: The QAG models (code to reproduce experiments).@inproceedings{ushio-etal-2023-an-empirical,
    title = "An Empirical Comparison of LM-based Question and Answer Generation Methods",
    author = "Ushio, Asahi  and
        Alva-Manchego, Fernando  and
        Camacho-Collados, Jose",
    booktitle = "Proceedings of the 61th Annual Meeting of the Association for Computational Linguistics: Findings",
    month = Jul,
    year = "2023",
    address = "Toronto, Canada",
    publisher = "Association for Computational Linguistics",
}A Practical Toolkit for Multilingual Question and Answer Generation, ACL 2023, System Demonstration: The library and demo (code to reproduce experiments).@inproceedings{ushio-etal-2023-a-practical-toolkit,
    title = "A Practical Toolkit for Multilingual Question and Answer Generation",
    author = "Ushio, Asahi  and
        Alva-Manchego, Fernando  and
        Camacho-Collados, Jose",
    booktitle = "Proceedings of the 61th Annual Meeting of the Association for Computational Linguistics: System Demonstrations",
    month = Jul,
    year = "2023",
    address = "Toronto, Canada",
    publisher = "Association for Computational Linguistics",
}