Skip to content

"Hafalin" app repository, a web app that could automatically generate academic questions (multiple choice and short answer) given a document in Indonesian, e.g. elementary school history lesson. Submitted for a Hackathon competition held by Kata.ai. More on it in https://blog.kata.ai/en/post/katahack-2-0-2/.

License

Notifications You must be signed in to change notification settings

geraldzakwan/tajong.ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tajong.ai

A web app that could automatically generate academic questions (multiple choice and short answer) given a document in Indonesian, for example, an elementary school history lesson. Submitted for a Hackathon competition held by Kata.ai. More on the competition: https://blog.kata.ai/en/post/katahack-2-0-2/.

How to Run

  • Install all requirements

    pip install -r requirements.txt

  • Run the web app

    python3 app.py

How to use API

  • Example Request using POST JSON
curl --location --request POST 'https://hafalin.herokuapp.com/generate_question/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "document": "Roro, Guntur, dan Kanguru baru saja selesai melakukan karya wisata ke Sumatera Barat yang terletak di Pulau Sumatera. Pulau ini berbatasan dengan Teluk Benggala pada sebelah utara, Selat Sunda pada sebelah selatan, Samudera Hindia pada sebelah barat, dan Selat Malaka pada sebelah timur. Sebelum pulang, supir bus sengaja membawa mereka mampir ke Pelabuhan Teluk Bayur yang merupakan salah satu dari lima pelabuhan terbesar dan tersibuk di Indonesia. Mereka juga melewati Provinsi Bengkulu, Sumatera Selatan, dan Lampung karena searah dengan jalan pulang menuju Jakarta.",
    "type": "all",
    "max_questions": 5
}'
  • Example Response in JSON
{
    "data": {
        "multiple_choice": [
            {
                "answer": "b",
                "choices": {
                    "a": "Jakarta",
                    "b": "Teluk Benggala",
                    "c": "Bengkulu",
                    "d": "Selat Malaka",
                    "e": "Selat Sunda"
                },
                "question": " Pulau ini berbatasan dengan  ...  pada sebelah utara, Selat Sunda pada sebelah selatan, Samudera Hindia pada sebelah barat, dan Selat Malaka pada sebelah timur"
            },
            {
                "answer": "c",
                "choices": {
                    "a": "Sumatera Selatan",
                    "b": "Sumatera Barat",
                    "c": "Selat Sunda",
                    "d": "Selat Sunda",
                    "e": "Selat Malaka"
                },
                "question": " Pulau ini berbatasan dengan Teluk Benggala pada sebelah utara,  ...  pada sebelah selatan, Samudera Hindia pada sebelah barat, dan Selat Malaka pada sebelah timur"
            },
            {
                "answer": "d",
                "choices": {
                    "a": "Bengkulu",
                    "b": "Sumatera Barat",
                    "c": "Indonesia",
                    "d": "Selat Malaka",
                    "e": "Jakarta"
                },
                "question": " Pulau ini berbatasan dengan Teluk Benggala pada sebelah utara, Selat Sunda pada sebelah selatan, Samudera Hindia pada sebelah barat, dan  ...  pada sebelah timur"
            },
            {
                "answer": "e",
                "choices": {
                    "a": "Sumatera Selatan",
                    "b": "Pulau Sumatera",
                    "c": "Teluk Benggala",
                    "d": "Bengkulu",
                    "e": "Pelabuhan Teluk Bayur"
                },
                "question": " Sebelum pulang, supir bus sengaja membawa mereka mampir ke  ...  yang merupakan salah satu dari lima pelabuhan terbesar dan tersibuk di Indonesia"
            },
            {
                "answer": "e",
                "choices": {
                    "a": "Bengkulu",
                    "b": "Pulau Sumatera",
                    "c": "Teluk Benggala",
                    "d": "Selat Malaka",
                    "e": "Indonesia"
                },
                "question": " Sebelum pulang, supir bus sengaja membawa mereka mampir ke Pelabuhan Teluk Bayur yang merupakan salah satu dari lima pelabuhan terbesar dan tersibuk di ..."
            },
            {
                "answer": "b",
                "choices": {
                    "a": "Jakarta",
                    "b": "Bengkulu",
                    "c": "Indonesia",
                    "d": "Sumatera Selatan",
                    "e": "Teluk Benggala"
                },
                "question": " Mereka juga melewati Provinsi  ... , Sumatera Selatan, dan Lampung karena searah dengan jalan pulang menuju Jakarta"
            }
        ],
        "short_answer": [
            {
                "answer": [
                    "Roro"
                ],
                "question": "... , Guntur, dan Kanguru baru saja selesai melakukan karya wisata ke Sumatera Barat yang terletak di Pulau Sumatera"
            },
            {
                "answer": [
                    "Sumatera Barat"
                ],
                "question": "Roro, Guntur, dan Kanguru baru saja selesai melakukan karya wisata ke  ...  yang terletak di Pulau Sumatera"
            },
            {
                "answer": [
                    "Pulau Sumatera"
                ],
                "question": "Roro, Guntur, dan Kanguru baru saja selesai melakukan karya wisata ke Sumatera Barat yang terletak di ..."
            },
            {
                "answer": [
                    "Teluk Benggala"
                ],
                "question": " Pulau ini berbatasan dengan  ...  pada sebelah utara, Selat Sunda pada sebelah selatan, Samudera Hindia pada sebelah barat, dan Selat Malaka pada sebelah timur"
            },
            {
                "answer": [
                    "Selat Sunda"
                ],
                "question": " Pulau ini berbatasan dengan Teluk Benggala pada sebelah utara,  ...  pada sebelah selatan, Samudera Hindia pada sebelah barat, dan Selat Malaka pada sebelah timur"
            },
            {
                "answer": [
                    "Selat Malaka"
                ],
                "question": " Pulau ini berbatasan dengan Teluk Benggala pada sebelah utara, Selat Sunda pada sebelah selatan, Samudera Hindia pada sebelah barat, dan  ...  pada sebelah timur"
            }
        ]
    }
}

About

"Hafalin" app repository, a web app that could automatically generate academic questions (multiple choice and short answer) given a document in Indonesian, e.g. elementary school history lesson. Submitted for a Hackathon competition held by Kata.ai. More on it in https://blog.kata.ai/en/post/katahack-2-0-2/.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages