canarim-7b / README.md
dominguesm's picture
Update README.md
a72b271 verified
metadata
language:
  - pt
license: llama2
library_name: transformers
tags:
  - text-generation
  - pytorch
  - LLM
  - Portuguese
  - Llama 2
datasets:
  - dominguesm/CC-MAIN-2023-23
inference: false
pipeline_tag: text-generation
model-index:
  - name: canarim-7b
    results:
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: AI2 Reasoning Challenge (25-Shot)
          type: ai2_arc
          config: ARC-Challenge
          split: test
          args:
            num_few_shot: 25
        metrics:
          - type: acc_norm
            value: 51.96
            name: normalized accuracy
        source:
          url: >-
            https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open LLM Leaderboard
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: HellaSwag (10-Shot)
          type: hellaswag
          split: validation
          args:
            num_few_shot: 10
        metrics:
          - type: acc_norm
            value: 77.52
            name: normalized accuracy
        source:
          url: >-
            https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open LLM Leaderboard
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: MMLU (5-Shot)
          type: cais/mmlu
          config: all
          split: test
          args:
            num_few_shot: 5
        metrics:
          - type: acc
            value: 40.92
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open LLM Leaderboard
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: TruthfulQA (0-shot)
          type: truthful_qa
          config: multiple_choice
          split: validation
          args:
            num_few_shot: 0
        metrics:
          - type: mc2
            value: 40.03
        source:
          url: >-
            https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open LLM Leaderboard
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: Winogrande (5-shot)
          type: winogrande
          config: winogrande_xl
          split: validation
          args:
            num_few_shot: 5
        metrics:
          - type: acc
            value: 71.43
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open LLM Leaderboard
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: GSM8k (5-shot)
          type: gsm8k
          config: main
          split: test
          args:
            num_few_shot: 5
        metrics:
          - type: acc
            value: 9.93
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open LLM Leaderboard
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: ENEM (3-shot)
          type: enem_challenge
          config: main
          split: test
          args:
            num_few_shot: 3
        metrics:
          - type: acc
            value: 26.96
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: BLUEX (3-shot)
          type: bluex
          config: main
          split: test
          args:
            num_few_shot: 3
        metrics:
          - type: acc
            value: 29.76
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: OAB Exams (3-shot)
          type: oab_exams
          config: main
          split: test
          args:
            num_few_shot: 3
        metrics:
          - type: acc
            value: 31.48
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: ASSIN2 RTE (15-shot)
          type: assin2_rte
          config: main
          split: test
          args:
            num_few_shot: 15
        metrics:
          - type: acc
            value: 71.96
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: ASSIN2 STS (15-shot)
          type: assin2_sts
          config: main
          split: test
          args:
            num_few_shot: 15
        metrics:
          - type: acc
            value: 13.33
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: FAQUAD NLI (15-shot)
          type: faquad_nli
          config: main
          split: test
          args:
            num_few_shot: 15
        metrics:
          - type: acc
            value: 49.09
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: HateBR (25-shot)
          type: hatebr_offensive
          config: main
          split: test
          args:
            num_few_shot: 25
        metrics:
          - type: acc
            value: 78.48
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: PT Hate Speech (25-shot)
          type: portuguese_hate_speech
          config: main
          split: test
          args:
            num_few_shot: 25
        metrics:
          - type: acc
            value: 63.73
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results
      - task:
          type: text-generation
          name: Text Generation
        dataset:
          name: tweetSentBR (25-shot)
          type: tweetsentbr
          config: main
          split: test
          args:
            num_few_shot: 25
        metrics:
          - type: acc
            value: 62.38
            name: accuracy
        source:
          url: >-
            https://huggingface.co/spaces/eduagarcia/open_pt_llm_leaderboard?query=dominguesm/canarim-7b
          name: Open PT LLM Leaderboard Evaluation Results

Camarim Logo


Canarim-7B

Canarim-7B is a Portuguese large language model developed by Maicon Domingues.

Model description

The model was pretrained on 16 billion tokens from the Portuguese subset of CommonCrawl 2023-23, starting with the weights of LLaMA2-7B. The pretraining data has cutoff of mid-2023.

Key Features

  • Language: Specialized in understanding and generating Portuguese text, making it ideal for applications targeting Portuguese-speaking audiences.
  • Architecture: Inherits the robust architecture from LLaMA2-7B, ensuring efficient performance and accurate results.
  • Diverse Dataset: The pretraining dataset includes a wide range of topics and writing styles, enhancing the model's ability to understand various contexts and nuances in Portuguese.

Applications

Canarim-7B, was trained solely on a language modeling objective and has not been fine-tuned for instruction following. Therefore, it is more suited for few-shot tasks rather than zero-shot tasks. This means the model tends to perform better when provided with a few examples of the desired outcome during use. Here are some practical applications:

  • Natural Language Understanding (NLU): Efficient in tasks such as sentiment analysis, topic classification, and entity recognition in Portuguese text, especially when relevant examples are provided.
  • Natural Language Generation (NLG): Capable of generating coherent and contextually relevant text, useful for content creation, chatbots, and more, with improved results when provided examples of the desired style or format.
  • Language Translation: Suitable for high-quality translation between Portuguese and other languages, especially when examples of desired translations are included during model training or fine-tuning.

Tips for Efficient Use

  • Few-shot Learning: When using Canarim-7B for specific tasks, it is beneficial to provide a few relevant examples. This helps the model better understand the context and purpose of the task.
  • Contextualization: Including additional context in the input can significantly improve the quality of the model’s predictions and text generation.

Getting Started

To start using Canarim-7B with the Transformers library, first install the library if you haven't already:

pip install transformers

You can then load the model using the Transformers library. Here's a simple example of how to use the model for text generation using the pipeline function:

from transformers import AutoTokenizer, pipeline
import torch

model_id = "dominguesm/canarim-7b"
tokenizer = AutoTokenizer.from_pretrained(model_id)

pipe = pipeline(
    "text-generation",
    model=model_id,
    torch_dtype=torch.float16,
    device_map="auto",
)

prompt = make_prompt(question)
sequences = pipe(
   prompt,
   do_sample=True,
   num_return_sequences=1,
   eos_token_id=tokenizer.eos_token_id,
   max_length=2048,
   temperature=0.9,
   top_p=0.6,
   repetition_penalty=1.15
)

This code snippet demonstrates how to generate text with Canarim-7B. You can customize the input text and adjust parameters like max_length according to your requirements.

How to Cite

If you want to cite Canarim-7B, you could use this:

@misc {maicon_domingues_2023,
    author       = { {Maicon Domingues} },
    title        = { canarim-7b (Revision 08fdd2b) },
    year         = 2023,
    url          = { https://huggingface.co/dominguesm/canarim-7b },
    doi          = { 10.57967/hf/1356 },
    publisher    = { Hugging Face }
}

Citations

@misc{touvron2023llama,
      title={Llama 2: Open Foundation and Fine-Tuned Chat Models},
      author={Hugo Touvron and Louis Martin and Kevin Stone and Peter Albert and Amjad Almahairi and Yasmine Babaei and Nikolay Bashlykov and Soumya Batra and Prajjwal Bhargava and Shruti Bhosale and Dan Bikel and Lukas Blecher and Cristian Canton Ferrer and Moya Chen and Guillem Cucurull and David Esiobu and Jude Fernandes and Jeremy Fu and Wenyin Fu and Brian Fuller and Cynthia Gao and Vedanuj Goswami and Naman Goyal and Anthony Hartshorn and Saghar Hosseini and Rui Hou and Hakan Inan and Marcin Kardas and Viktor Kerkez and Madian Khabsa and Isabel Kloumann and Artem Korenev and Punit Singh Koura and Marie-Anne Lachaux and Thibaut Lavril and Jenya Lee and Diana Liskovich and Yinghai Lu and Yuning Mao and Xavier Martinet and Todor Mihaylov and Pushkar Mishra and Igor Molybog and Yixin Nie and Andrew Poulton and Jeremy Reizenstein and Rashi Rungta and Kalyan Saladi and Alan Schelten and Ruan Silva and Eric Michael Smith and Ranjan Subramanian and Xiaoqing Ellen Tan and Binh Tang and Ross Taylor and Adina Williams and Jian Xiang Kuan and Puxin Xu and Zheng Yan and Iliyan Zarov and Yuchen Zhang and Angela Fan and Melanie Kambadur and Sharan Narang and Aurelien Rodriguez and Robert Stojnic and Sergey Edunov and Thomas Scialom},
      year={2023},
      eprint={2307.09288},
      archivePrefix={arXiv},
      primaryClass={cs.CL}
}

License

Canarim-7B is released under the LLAMA 2 COMMUNITY LICENSE AGREEMENT.

Open PT LLM Leaderboard Evaluation Results

Detailed results can be found here

Metric Value
Avg. 47.36
ENEM (3-Shot) 25.96
BLUEX (3-Shot) 29.76
OAB Exams (3-Shot) 31.48
ASSIN2 RTE (15-shot) 71.96
ASSIN2 STS (15-shot) 13.33
FAQUAD NLI (15-shot) 49.09
HateBR (25-shot) 78.48
PT Hate Speech (25-shot) 63.73
tweetSentBR (25-shot) 62.38

Open LLM Leaderboard Evaluation Results

Detailed results can be found here

Metric Value
Avg. 48.63
AI2 Reasoning Challenge (25-Shot) 51.96
HellaSwag (10-Shot) 77.52
MMLU (5-Shot) 40.92
TruthfulQA (0-shot) 40.03
Winogrande (5-shot) 71.43
GSM8k (5-shot) 9.93