Update README.md

README.md

@@ -7,47 +7,211 @@ language:
 - es
 thumbnail: https://huggingface.co/clibrain/lince-zero/resolve/main/lince_logo_1.png
 pipeline_tag: text-generation
+datasets:
+- tatsu-lab/alpaca
+- databricks/databricks-dolly-15k
+library_name: transformers
 ---
 
-# Lince Zero 🐯
+LINCE (Llm for Instructions from Natural Corpus en Español) is a state-of-the-art Spanish instruction language model. Developed by **[Clibrain](https://www.clibrain.com/)**, it is a causal decoder-only model with 7B parameters. LINCE-ZERO is based on **[Falcon-7B](https://huggingface.co/tiiuae/falcon-7b/blob/main/README.md)** and has been fine-tuned using an augmented combination of the **[Alpaca](https://huggingface.co/datasets/tatsu-lab/alpaca)** and **[Dolly](https://huggingface.co/datasets/databricks/databricks-dolly-15k)** datasets, both translated into Spanish.
+
+The model is released under the Apache 2.0 license.
 
 <div style="text-align:center;width:250px;height:250px;">
-    <img src="https://huggingface.co/clibrain/lince-zero/resolve/main/LINCE-CLIBRAIN-HD.jpg" alt="lince logo"">
+    <img src="https://huggingface.co/clibrain/lince-zero/resolve/main/lince_logo_1.png" alt="lince logo"">
 </div>
 
+# Model Card for LINCE-ZERO
+
+**LINCE-ZERO** is a model fine-tuned on a massive and original corpus of Spanish instructions.
+
+# Table of Contents
+
+- [Model Details](#model-details)
+  - [Model Description](#model-description)
+- [Uses](#uses)
+  - [Direct Use](#direct-use)
+  - [Downstream Use](#downstream-use)
+  - [Out-of-Scope Use](#out-of-scope-use)
+- [Bias, Risks, and Limitations](#bias-risks-and-limitations)
+  - [Recommendations](#recommendations)
+- [Training Details](#training-details)
+  - [Training Data](#training-data)
+  - [Training Procedure](#training-procedure)
+    - [Preprocessing](#preprocessing)
+    - [Speeds, Sizes, Times](#speeds-sizes-times)
+- [Evaluation](#evaluation)
+  - [Testing Data, Factors & Metrics](#testing-data-factors--metrics)
+    - [Testing Data](#testing-data)
+    - [Factors](#factors)
+    - [Metrics](#metrics)
+  - [Results](#results)
+- [Model Examination](#model-examination)
+- [Environmental Impact](#environmental-impact)
+- [Technical Specifications](#technical-specifications)
+  - [Model Architecture and Objective](#model-architecture-and-objective)
+  - [Compute Infrastructure](#compute-infrastructure)
+    - [Hardware](#hardware)
+    - [Software](#software)
+- [Citation](#citation)
+- [Contact](#contact)
+- [How to Get Started with the Model](#how-to-get-started-with-the-model)
+
+# Model Details
+
+## Model Description
+
+LINCE-ZERO (Llm for Instructions from Natural Corpus en Español) is a state-of-the-art Spanish instruction language model. Developed by **[Clibrain](https://www.clibrain.com/)**, it is a causal decoder-only model with 7B parameters. LINCE-ZERO is based on **[Falcon-7B**](https://huggingface.co/tiiuae/falcon-7b/blob/main/README.md) and has been fine-tuned using an augmented combination of the **[Alpaca](https://huggingface.co/datasets/tatsu-lab/alpaca)** and **[Dolly](https://huggingface.co/datasets/databricks/databricks-dolly-15k)** datasets, both translated into Spanish.
+
+- **Developed by:** [Clibrain](https://www.clibrain.com/)
+- **Model type:** Language model, instruction model, causal decoder-only
+- **Language(s) (NLP):** es
+- **License:** apache-2.0
+- **Parent Model:** [https://huggingface.co/tiiuae/falcon-7b](https://huggingface.co/tiiuae/falcon-7b)
+- **Resources for more information:** Paper coming soon
+
+## Model Sources
+
+- **Paper**: Coming soon!
+- **Demo**: Coming soon!
+
+# Uses
+
+## Direct Use
+
+LINCE-ZERO's fine-tuning on an instructions dataset enables it to follow natural language instructions in Spanish. The direct use cases include virtual assistants and content generation.
+
+Please note that running inference with LINCE-ZERO efficiently requires a minimum of XGB of memory.
+
+## Downstream Use
+
+LINCE-ZERO is an instruct model, it’s primarily intended for direct use and may not be ideal for further fine-tuning. It serves as a general model suitable for a wide range of applications. However, for specific use cases within certain domains, fine-tuning with domain-specific data may improve LINCE-ZERO's performance.
+
+## Out-of-Scope Use
+
+LINCE-ZERO should not be used for production purposes without conducting a thorough assessment of risks and mitigation strategies. 
+
+# Bias, Risks, and Limitations
+
+LINCE-ZERO has limitations associated with both the underlying language model and the instruction tuning data. It is crucial to acknowledge that predictions generated by the model may inadvertently exhibit common deficiencies of language models, including hallucination, toxicity, and perpetuate harmful stereotypes across protected classes, identity characteristics, and sensitive, social, and occupational groups.
+
+Since the model has been fine-tuned on translated versions of the Alpaca and Dolly datasets, it has potentially inherited certain limitations and biases:
+
+- Alpaca: The Alpaca dataset is generated by a language model (`text-davinci-003`) and inevitably contains some errors or biases inherent in that model. As the authors report, hallucination seems to be a common failure mode for Alpaca, even compared to text-davinci-003.
+- Dolly: The Dolly dataset incorporates information from Wikipedia, which is a crowdsourced corpus. Therefore, the dataset's contents may reflect the biases, factual errors, and topical focus present in Wikipedia. Additionally, annotators involved in the dataset creation may not be native English speakers, and their demographics and subject matter may reflect the makeup of Databricks employees.
+
+## Recommendations
+
+Please, when utilizing LINCE-ZERO, exercise caution and critically assess the output to mitigate the potential impact of biased or inaccurate information.
+
+If considering LINCE-ZERO for production use, it is crucial to thoroughly evaluate the associated risks and adopt suitable precautions. Conduct a comprehensive assessment to address any potential biases and ensure compliance with legal and ethical standards.
+
+# Training Details
+
+## Training Data
+
+LINCE-ZERO is based on **[Falcon-7B](https://huggingface.co/tiiuae/falcon-7b)** and has been fine-tuned using an augmented combination of the **[Alpaca](https://huggingface.co/datasets/tatsu-lab/alpaca)** and **[Dolly](https://huggingface.co/datasets/databricks/databricks-dolly-15k)** datasets, both translated into Spanish.
+
+Alpaca is a 24.2 MB dataset of 52,002 instructions and demonstrations in English. It was generated by OpenAI's `text-davinci-003` engine using the data generation pipeline from the [Self-Instruct framework](https://github.com/yizhongw/self-instruct) with some modifications. For further details, refer to [Alpaca's Data Card](https://huggingface.co/datasets/tatsu-lab/alpaca).
+
+Dolly is a 13.1 MB dataset of 15,011 instruction-following records in American English. It was generated by thousands of Databricks employees, who were requested to provide reference texts copied from Wikipedia for specific categories. To learn more, consult [Dolly’s Data Card](https://huggingface.co/datasets/databricks/databricks-dolly-15k).
 
-**Lince** is model fine-tuned on a massive and original corpus of Spanish instructions.
+## Training Procedure
 
-## Model description 🧠
+For detailed information about the model architecture and compute infrastructure, please refer to the Technical Specifications section.
 
-TBA
+### Preprocessing
 
+To prepare the training data, both the Alpaca and Dolly datasets, originally in English, were translated into Spanish using …
 
-## Training and evaluation data 📚
+The data was tokenized using LINCE-ZERO’s tokenizer, which is based on the Falcon-**[7B](https://huggingface.co/tiiuae/falcon-7b)**/**[40B](https://huggingface.co/tiiuae/falcon-40b)** tokenizer.
 
-We created an instruction dataset following the format or popular datasets in the field such as *Alpaca* and *Dolly* and augmented it to reach **80k** samples.
+### Training Hyperparameters
 
+More information needed
 
-### Training hyperparameters ⚙
+### Speeds, Sizes, Times
 
-TBA
+More information needed (throughput, start/end time, checkpoint size if relevant, etc.)
 
-### Training results 🗒️
+# Evaluation
 
-TBA
+## Testing Data, Factors & Metrics
 
+### Testing Data
+
+The model has been tested on a X% of the augmented combination of Alpaca (24.2 MB) and Dolly (13.1 MB) translated into Spanish.
+
+### Metrics
+
+Since LINCE-ZERO is an instruction model, the metrics used to evaluate it are:
+
+- X: <value>
+
+### Results
+
+Paper coming soon. Meanwhile, check the [OpenLLM Leaderboard](https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard).
+
+# Technical Specifications
+
+## Model Architecture and Objective
+
+LINCE-ZERO is a causal decoder-only model trained on a causal language modeling task. Its objective is to predict the next token in a sequence based on the context provided.
+
+The architecture of LINCE-ZERO is based on Falcon-7B, which itself is adapted from the GPT-3 paper (Brown et al., 2020) with the following modifications:
+
+- Positional embeddings: rotary (Su et al., 2021);
+- Attention: multiquery (Shazeer et al., 2019) and FlashAttention (Dao et al., 2022);
+- Decoder-block: parallel attention/MLP with a single-layer norm.
+
+## Compute Infrastructure
+
+### Hardware
+
+LINCE-ZERO was trained on AWS SageMaker, on ... GPUs in ... instances.
+
+### Software
+
+More information needed
+
+# Environmental Impact
+
+Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
+
+- **Hardware Type:** More information needed
+- **Hours used:** More information needed
+- **Cloud Provider:** More information needed
+- **Compute Region:** More information needed
+- **Carbon Emitted:** More information needed
+
+# Citation
+
+There is a paper coming soon! Meanwhile, when using LINCE-ZERO please use the following information to cite:
+
+```markdown
+@article{lince-zero,
+  title={{LINCE}: Llm for Instructions from Natural Corpus en Español},
+  author={},
+  year={2023}
+}
+```
+
+# Contact
+
+[[email protected]](mailto:[email protected])
+
+# How to Get Started with LINCE-ZERO
+
+Use the code below to get started with LINCE-ZERO 🔥
 
-### Example of usage 👩‍💻
 ```py
 import torch
 from transformers import AutoModelForCausalLM, AutoTokenizer, AutoTokenizer
 
 model_id = "clibrain/lince-zero"
 
-tokenizer = AutoTokenizer.from_pretrained(model_id)
-
 model = AutoModelForCausalLM.from_pretrained(model_id).to("cuda")
-
+tokenizer = AutoTokenizer.from_pretrained(model_id)
 
 def create_instruction(instruction, input_data=None, context=None):
     sections = {