This is the primary code base for the project:

Lawma: The Power of Specizalization for Legal Tasks. Ricardo Dominguez-Olmedo and Vedant Nanda and Rediet Abebe and Stefan Bechtold and Christoph Engel and Jens Frankenreiter and Krishna Gummadi and Moritz Hardt and Michael Livermore. 2024

Lawma 8B and Lawma 70B are language models fine-tuned on 260 legal classification tasks derived from the Supreme Court and Songer Court of Appeals databases. The Lawma models outperform GPT-4 on 95% of these legal classification tasks, on average by over 17 accuracy points.

• The models: Lawma 8B and Lawma 70B are fine-tunes of Llama 3 Instruct.
• The fine-tuning dataset: our fine-tuning dataset contains a diverse set of 260 legal classification tasks, with around 500k task examples and 2 billion tokens.
• The legal classification tasks: they comprise almost all of the variables of the Supreme Court and Songer Court of Appeals databases, see Appendix B.
• The details: see our arXiv preprint for more details, including a number of fine-tuning experiments on the scaling behaviour of fine-tuning, its sample efficiency, its generalization to unseen tasks and Courts, and the effect of single task specialization.

What are the Lawma models useful for? We recommend using the Lawma models only for the legal classification tasks that they models were fine-tuned on. The main take-away of our paper is that specializing models leads to large improvements in performance. Therefore, we strongly recommend practitioners to further fine-tune Lawma on the actual tasks that the models will be used for. Relatively few examples --i.e, dozens or hundreds-- may already lead to large gains in performance.

Why these legal classification tasks? Our reasons to study legal classification tasks are both technical and substantive. From a technical machine learning perspective, these tasks provide highly non-trivial classification problems where even the best models leave much room for improvement. From a substantive legal perspective, efficient solutions to such classification problems have rich and important applications in legal research. We provide code to evaluate the performance of HF models on these classification tasks.

To evaluate language models on each of the 260 legal tasks, please refer to the evaluation folder, and in particular hf_eval.py. You must first download the task files from here, or generate them yourself by following the instructions in the data_generation folder. We evaluated a range of language models:

The Lawma models substantially outperform all other models tested, and in particular GPT-4. Note that, while Lawma 70B generally outperforms Lawma 8B, the difference in performance is typically rather small. Therefore, practitioners may prefer to use Lawma 8B for its significantly cheaper inference and fine-tuning, with little cost in terms of model performance.

Note: evaluating models on all 260 classification tasks is reasonably compute intensive. However, for the purposes of language model benchmarking we may be mostly interested in aggregate performance. We are currently working on making aggregate evaluations less resource intensive by only considering a limited number of examples per task.

We fine-tune Lawma using the axolotl library. Please refer to the README in the fine-tune folder for the training scripts and configuration files that we used to fine-tune Lawma.

To fine-tune on our dataset of legal classification tasks, simply indicate so in your config.yml file:

datasets:
  - path: ricdomolm/lawma-all-tasks
    type: alpaca

and then train using axolotl as usual

accelerate launch -m axolotl.cli.train config.yml

Fine-tuning Lawma 8B on 7xH100 GPUs required a total of 600 H100 hours (3 epochs), whereas fine-tuning Lawma 70B on 8 H100 nodes of 8 GPUs each required around 1600 H100 hours (1 epoch). We find that further epochs hurt average task performance.

To reproduce the results of the paper, take the following steps:

• Go to data_generation for all code to create the classification tasks and the fine-tuning dataset.
• The directory evaluation contains code used to evaluate various models on the classification tasks.
• The directory fine-tune contains code to fine-tune Lawma, as well as the for the additional fine-tuning experiments included in the paper.
• The directory notebooks contains ipynb files to generate the plots and tables of the paper.

See the README.md files in the subdirectories for additional documentation.

Please cite as:

@misc{dominguezolmedo2024lawmapowerspecializationlegal,
      title={Lawma: The Power of Specialization for Legal Tasks}, 
      author={Ricardo Dominguez-Olmedo and Vedant Nanda and Rediet Abebe and Stefan Bechtold and Christoph Engel and Jens Frankenreiter and Krishna Gummadi and Moritz Hardt and Michael Livermore},
      year={2024},
      eprint={2407.16615},
      archivePrefix={arXiv},
      primaryClass={cs.CL},
      url={https://arxiv.org/abs/2407.16615}, 
}