Claire-7B-0.1 is a 7B parameter causal decoder-only model built by LINAGORA with the support of OpenLLM-Franceadapted from Falcon-7b on French conversational data.
Claire-7B-0.1 is a pretrained language model designed to be attuned to the dynamics of linguistic interactions in dialogue. Without further training, its expected use is to generate continuations of dialogues. Its main purpose is to serve as a base model for fine-tuning on dialogue generation (e.g., chat) and dialogue understanding (e.g., meeting summarization) tasks. Please note that due to its training, the model is prone to generate dialogues with disfluencies and other constructions common to spoken language.
1import transformers
2import torch
34model_name ="OpenLLM-France/Claire-7B-0.1"56tokenizer = transformers.AutoTokenizer.from_pretrained(model_name)7model = transformers.AutoModelForCausalLM.from_pretrained(model_name,8 device_map="auto",9 torch_dtype=torch.bfloat16,10 load_in_4bit=True# For efficient inference, if supported by the GPU card11)1213pipeline = transformers.pipeline("text-generation", model=model, tokenizer=tokenizer)14generation_kwargs =dict(15 num_return_sequences=1,# Number of variants to generate.16 return_full_text=False,# Do not include the prompt in the generated text.17 max_new_tokens=200,# Maximum length for the output text.18 do_sample=True, top_k=10, temperature=1.0,# Sampling parameters.19 pad_token_id=tokenizer.eos_token_id,# Just to avoid a harmless warning.20)2122prompt ="""\
23- Bonjour Dominique, qu'allez-vous nous cuisiner aujourd'hui ?
24- Bonjour Camille,\
25"""26completions = pipeline(prompt,**generation_kwargs)27for completion in completions:28print(prompt +" […]"+ completion['generated_text'])
This will print something like:
- Bonjour Dominique, qu'allez-vous nous cuisiner aujourd'hui ?
- Bonjour Camille, […] je vous prépare un plat de saison, une daube provençale.
- Ah je ne connais pas cette recette.
- C'est très facile à préparer, vous n'avez qu'à mettre de l'eau dans une marmite, y mettre de l'oignon émincé, des carottes coupées en petits morceaux, et vous allez mettre votre viande de bœuf coupé en petits morceaux également.
- Je n'ai jamais cuisiné de viande de bœuf, mais c'est vrai que ça a l'air bien facile.
- Vous n'avez plus qu'à laisser mijoter, et ensuite il sera temps de servir les clients.
- Très bien.
You will need at least 6GB of VRAM to run inference using 4bit quantization (16GB of VRAM without 4bit quantization).
If you have trouble running this code, make sure you have recent versions of torch, transformers and accelerate (see requirements.txt).
Typical prompts
Claire-7B-0.1 was trained on diarized French conversations. During training, the dialogues were normalized in several formats. The possible formats for expected prompts are as follows:
A monologue can be specified as a single line prompt (though keep in mind that Claire might still return a dialogue because of its training):
prompt = "Mesdames et messieurs les députés, chers collègues, bonsoir. Vous l'aurez peut-être remarqué, je cite rarement"
A dialogue between two speakers can be specified with one line per speech turn starting with a dash:
python
1prompt ="""\
2- Bonjour Dominique, qu'allez-vous nous cuisiner aujourd'hui ?
3- Bonjour Camille,\
4"""
A dialogue or multilogue (with two or more speakers) can be specified with lines that start with [Intervenant X:] where X is a number:
python
1prompt ="""\
2[Intervenant 1:] Bonjour Dominique, qu'allez-vous nous cuisiner aujourd'hui ?
3[Intervenant 2:] Bonjour Camille,\
4"""
A dialogue or multilogue with named speakers can be specified with lines that start with [SpeakerName:]
where SpeakerName can be a first name, a first and a last name, a nickname, a title…
python
1prompt ="""\
2[Mme Camille Durand:] Bonjour Dominique, qu'allez-vous nous cuisiner aujourd'hui ?
3[Mr. Dominique Petit:] Bonjour Camille,\
4"""
Training data was augmented with the following techniques:
varying the format used to indicate speech turns (dashes or [XXX:])
substituting [Intervenant X:] for [SpeakerName:] or vice versa, where [SpeakerName:] might be a real name or a randomly generated name
removing punctuation marks and/or casing (to prepare the model for transcripts produced by some Automatic Speech Recognition systems)
Long conversations were truncated at a maximum of 2048 tokens. Where possible, they were split between speaker turns.
While the model has been trained and evaluated only on French dialogues, it may be able to generate conversations in other languages from the original Falcon-7b training data.
Claire-7B-0.1 is a causal decoder-only model trained on a causal language modeling task (i.e., predict the next token).
See Falcon-7b for more details.
Claire-7B-0.1 was trained on 1 A100 80GB GPU for about 50 GPU hours.
Hyperparameters were the following:
Hyperparameter
Value
Precision
bfloat16
Optimizer
AdamW
Learning rate
1e-4
Weight decay
1e-2
Batch size
132
LoRA rank
16
LoRA alpha
32
Dropout
0.05
gradient clipping
1
Evaluation
To evaluate Claire-7B-0.1’s ability to generate natural sounding, French conversations, we compared its responses to a variety of prompts with those of three other models:
Claire-Mistral-7B-0.1 (a version of Mistral-7B-v0.1 adapted in the same fashion as Claire-7B-0.1)
We tested an even mixture of monologue and dialogue-style prompts.
Each of the four generated responses was evaluated along three dimensions:
Interaction, Fluency and Relevance.
Evaluators were also asked to rank the four responses by preference.
Our results confirm that continual pre-training of Falcon-7b and Mistral-7B-v0.1 leads to improvement (relative to the base models) along all three evaluation dimensions and that Claire-7B-0.1 outperforms the adapted Mistral counterpart in the Fluency and Relevance categories
(and in the Interaction category if we focus on dialogue-style prompts).
Ranking results also reveal a clear subjective preference for Claire-7B-0.1,
as shown in the following table:
Please note that the model can generate disfluencies and humorous responses as a result of its training on spoken and theatrical text.
More evaluation details will be provided in a separate publication.
Variants
Claire-7B-0.1 is finetuned only on French dialogue data, but the following variants are available to evaluate the impact of language mixture on dialogue understanding.
Given that some of the corpora used for training are only available under CC-BY-NC-SA licenses,
Claire-7B-0.1 is made available under the CC-BY-NC-SA 4.0 license.
When using the Claire family of models, please cite the following paper:
Jérôme Louradour, Julie Hunter, Ismaïl Harrando, Guokan Shang, Virgile Rennard & Jean-Pierre Lorré (2024). Claire: Large Language Models for Spontaneous French Dialogue. In Actes de la 31ème Conférence sur le Traitement Automatique des Langues Naturelles, volume 1: articles longs et prises de position (pp. 530-548).
bibtex
1@inproceedings{louradour2024claire,
2 title={Claire: Large Language Models for Spontaneous French Dialogue},
3 author={Louradour, J{\'e}r{\^o}me and Hunter, Julie and Harrando, Isma{\"\i}l and Shang, Guokan and Rennard, Virgile and Lorr{\'e}, Jean-Pierre},
4 booktitle={Actes de la 31{\`e}me Conf{\'e}rence sur le Traitement Automatique des Langues Naturelles, volume 1: articles longs et prises de position},
5 pages={530--548},
6 year={2024}
7}
Acknowledgements
This work was performed using HPC resources from GENCI–IDRIS (Grant 2023-AD011014561).
Special thanks to partners from the OpenLLM-France community, especially Christophe Cerisara (LORIA), Pierre-Carl Langlais and Anastasia Stasenko (OpSci), and Pierre Colombo, for valuable advice.
