initial commit (#1)

- initial commit (5baef78c4bcac16988c15b4d66a0288af40232f8)


Co-authored-by: Ziling Cheng <oooooorange@users.noreply.huggingface.co>

README.md

@@ -1 +1,101 @@
-Coming soon.
+---
+# For reference on model card metadata, see the spec: https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1
+# Doc / guide: https://huggingface.co/docs/hub/model-cards
+{}
+---
+
+# Varta T5 model
+
+<!-- Provide a quick summary of what the model is/does. -->
+
+## Model Description
+Varta T5 is a model pre-trained on full training set from Varta on English and 14 Indic languages (Assamese, Bhojpuri, Bengali, Gujarati, Hindi, Kannada, Malayalam, Marathi, Nepali, Oriya, Punjabi, Tamil, Telugu, and Urdu) using span corruption and gap-sentence generation as objectives from scratch. 
+Varta is a large-scale headline-generation dataset for Indic languages, including 41.8 million news articles in 14 different Indic languages (and English), which come from a variety of high-quality sources. 
+
+
+The dataset and the model were introduced in [this paper](https://arxiv.org/pdf/2305.05858.pdf). The code was released in [this repository](https://github.com/rahular/varta). The data was released in [this bucket](https://console.cloud.google.com/storage/browser/varta-eu/data-release).
+
+
+## Uses
+
+<!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
+
+You can use the raw model for language modelling, but it's mostly intended to be fine-tuned on a downstream task. <br>
+
+
+Note that the text-to-text framework allows us to use the same model on any NLP task, including text generation tasks (e.g., machine translation, document summarization, question answering), and classification tasks (e.g., sentiment analysis). 
+
+
+## Bias, Risks, and Limitations
+
+<!-- This section is meant to convey both technical and sociotechnical limitations. -->
+
+This work is mainly dedicated to the curation of a new multilingual dataset for Indic languages, many of which are low-resource languages. During data collection, we face several limitations that can potentially result in ethical concerns. Some of the important ones are mentioned below: <br>
+
+- Our dataset contains only those articles written by DailyHunt's partner publishers. This has the potential to result in a bias towards a particular narrative or ideology that can affect the representativeness and diversity of the dataset.
+- Another limitation is the languages represented in Varta. Out of 22 languages with official status in India, our dataset has only 13. There are 122 major languages spoken by at least 10,000 people and 159 other languages which are extremely low-resourced. None of these languages are represented in our dataset.
+- We do not perform any kind of debiasing on Varta. This means that societal and cultural biases may exist in the dataset, which can adversely affect the fairness and inclusivity of the models trained on it.
+
+
+## How to Get Started with the Model
+
+You can use this model directly with a pipeline for language modeling.
+
+```python
+from transformers import AutoTokenizer, AutoModelForSeq2SeqLM
+
+tokenizer = AutoTokenizer.from_pretrained("rahular/varta-t5")
+
+model = AutoModelForSeq2SeqLM.from_pretrained("rahular/varta-t5")
+```
+
+
+## Training Details
+
+### Training Data
+Varta contains 41.8 million high-quality news articles in 14 Indic languages and English. 
+With 34.5 million non-English article-headline pairs, it is the largest headline-generation dataset of its kind. 
+
+### Pretraining
+We use span corruption and gap-sentence generation as the pretraining objectives. 
+Both objectives are sampled uniformly during pretraining. 
+Span corruption is similar to masked language modeling except that instead of masking random tokens, we mask spans of tokens with an average length of 3. 
+In gap-sentence prediction, whole sentences are masked instead of spans. We follow the original work, and select sentences based on their `importance'. 
+Rouge-1 F1-score between the sentence and the document is used as a proxy for importance. 
+We use 0.15 and 0.2 as the masking ratios for span corruption and gap-sentence generation, respectively.
+
+Since data sizes across languages in Varta vary from 1.5K (Bhojpuri) to 14.4M articles (Hindi), we use standard temperature-based sampling to upsample data when necessary.
+
+We pretrain Varta-T5 using the T5 1.1 base architecture with 12 encoder and decoder layers. 
+We train with maximum sequence lengths of 512 and 256 for the encoder and decoder respectively. 
+We use 12 attention heads with an embedding dimension of 768 and a feed-forward width of 2048. 
+We use a 128K sentencepiece vocabulary. 
+In total, the model has 395M parameters. 
+The model is trained with Adafactor optimizer with a warm-up of 10K steps. 
+We use an initial learning rate of 1e-3 and use square root decay till we reach 2M steps. 
+We use an effective batch size of 256 and train the model on TPU v3-8 chips. 
+The model takes 11 days to train.
+
+<!-- This should link to a Data Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
+
+### Evaluation Results
+To come.
+
+## Citation
+
+<!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
+
+```
+@misc{aralikatte2023varta,
+      title={V\=arta: A Large-Scale Headline-Generation Dataset for Indic Languages}, 
+      author={Rahul Aralikatte and Ziling Cheng and Sumanth Doddapaneni and Jackie Chi Kit Cheung},
+      year={2023},
+      eprint={2305.05858},
+      archivePrefix={arXiv},
+      primaryClass={cs.CL}
+}
+```
+
+
+
+