Create README.md
Browse files
README.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: llama2
|
| 3 |
+
datasets:
|
| 4 |
+
- gsm8k
|
| 5 |
+
- competition_math
|
| 6 |
+
language:
|
| 7 |
+
- en
|
| 8 |
+
metrics:
|
| 9 |
+
- exact_match
|
| 10 |
+
library_name: transformers
|
| 11 |
+
pipeline_tag: text-generation
|
| 12 |
+
tags:
|
| 13 |
+
- code
|
| 14 |
+
- math
|
| 15 |
+
---
|
| 16 |
+
|
| 17 |
+
|
| 18 |
+
<h1 align="center">
|
| 19 |
+
ToRA: A Tool-Integrated Reasoning Agent <br> for Mathematical Problem Solving
|
| 20 |
+
</h1>
|
| 21 |
+
|
| 22 |
+
<p align="center">
|
| 23 |
+
<a href="https://microsoft.github.io/ToRA/"><b>[🌐 Website]</b></a> •
|
| 24 |
+
<a href="https://arxiv.org/pdf/2309.17452.pdf"><b>[📜 Paper]</b></a> •
|
| 25 |
+
<a href="https://huggingface.co/llm-agents"><b>[🤗 HF Models]</b></a> •
|
| 26 |
+
<a href="https://github.com/microsoft/ToRA"><b>[🐱 GitHub]</b></a>
|
| 27 |
+
<br>
|
| 28 |
+
<a href="https://twitter.com/zhs05232838/status/1708860992631763092"><b>[🐦 Twitter]</b></a> •
|
| 29 |
+
<a href="https://www.reddit.com/r/LocalLLaMA/comments/1703k6d/tora_a_toolintegrated_reasoning_agent_for/"><b>[💬 Reddit]</b></a> •
|
| 30 |
+
<a href="https://notes.aimodels.fyi/researchers-announce-tora-training-language-models-to-better-understand-math-using-external-tools/">[🍀 Unofficial Blog]</a>
|
| 31 |
+
<!-- <a href="#-quick-start">Quick Start</a> • -->
|
| 32 |
+
<!-- <a href="#%EF%B8%8F-citation">Citation</a> -->
|
| 33 |
+
</p>
|
| 34 |
+
|
| 35 |
+
<p align="center">
|
| 36 |
+
Repo for "<a href="https://arxiv.org/pdf/2309.17452.pdf" target="_blank">ToRA: A Tool-Integrated Reasoning Agent for Mathematical Problem Solving</a>"
|
| 37 |
+
</p>
|
| 38 |
+
|
| 39 |
+
## 🔥 News
|
| 40 |
+
|
| 41 |
+
- [2023/10/08] 🔥🔥🔥 All ToRA models released at [HuggingFace](https://huggingface.co/llm-agents)!!!
|
| 42 |
+
- [2023/09/29] ToRA paper, repo, and website released.
|
| 43 |
+
|
| 44 |
+
## 💡 Introduction
|
| 45 |
+
|
| 46 |
+
ToRA is a series of Tool-integrated Reasoning Agents designed to solve challenging mathematical reasoning problems by interacting with tools, e.g., computation libraries and symbolic solvers. ToRA series seamlessly integrate natural language reasoning with the utilization of external tools, thereby amalgamating the analytical prowess of language and the computational efficiency of external tools.
|
| 47 |
+
|
| 48 |
+
| Model | Size | GSM8k | MATH | AVG@10 math tasks<sup>†</sup> |
|
| 49 |
+
|---|---|---|---|---|
|
| 50 |
+
| GPT-4 | - | 92.0 | 42.5 | 78.3 |
|
| 51 |
+
| GPT-4 (PAL) | - | 94.2 | 51.8 | 86.4 |
|
| 52 |
+
| [ToRA-7B](https://huggingface.co/llm-agents/tora-7b-v1.0) | 7B | 68.8 | 40.1 | 62.4|
|
| 53 |
+
| [ToRA-Code-7B](https://huggingface.co/llm-agents/tora-code-7b-v1.0) | 7B | 72.6 | 44.6 | 66.5|
|
| 54 |
+
| [ToRA-13B](https://huggingface.co/llm-agents/tora-13b-v1.0) | 13B | 72.7 | 43.0 | 65.9|
|
| 55 |
+
| [ToRA-Code-13B](https://huggingface.co/llm-agents/tora-code-13b-v1.0) | 13B | 75.8 | 48.1 | 71.3 |
|
| 56 |
+
| [ToRA-Code-34B<sup>*</sup>](https://huggingface.co/llm-agents/tora-code-34b-v1.0) | 34B | 80.7 | **51.0** | 74.8 |
|
| 57 |
+
| [ToRA-70B](https://huggingface.co/llm-agents/tora-70b-v1.0) | 70B | **84.3** | 49.7 | **76.9** |
|
| 58 |
+
|
| 59 |
+
- <sup>*</sup>ToRA-Code-34B is currently the first and only open-source model to achieve over 50% accuracy (pass@1) on the MATH dataset, which significantly outperforms GPT-4’s CoT result (51.0 vs. 42.5), and is competitive with GPT-4 solving problems with programs. By open-sourcing our codes and models, we hope more breakthroughs will come!
|
| 60 |
+
|
| 61 |
+
- <sup>†</sup>10 math tasks include GSM8k, MATH, GSM-Hard, SVAMP, TabMWP, ASDiv, SingleEQ, SingleOP, AddSub, and MultiArith.
|
| 62 |
+
|
| 63 |
+
|
| 64 |
+
## ⚡️ Training
|
| 65 |
+
|
| 66 |
+
The models are trained on ToRA-Corpus 16k, which contains tool-integrated reasoning trajectories of MATH and GSM8k from GPT-4.
|
| 67 |
+
|
| 68 |
+
We use imitation learning (i.e., SFT) to fine-tune the models, and then apply our proposed *output space shaping* to improve tool-integrated reasoning behaviors. Please refer to the [paper](https://arxiv.org/pdf/2309.17452.pdf) for more details.
|
| 69 |
+
|
| 70 |
+
|
| 71 |
+
## 🪁 Inference & Evaluation
|
| 72 |
+
|
| 73 |
+
Please refer to ToRA's [GitHub repo](https://github.com/microsoft/ToRA) for inference, evaluation, and training code.
|
| 74 |
+
|
| 75 |
+
|
| 76 |
+
## ☕️ Citation
|
| 77 |
+
|
| 78 |
+
If you find this repository helpful, please consider citing our paper:
|
| 79 |
+
|
| 80 |
+
```
|
| 81 |
+
@misc{gou2023tora,
|
| 82 |
+
title={ToRA: A Tool-Integrated Reasoning Agent for Mathematical Problem Solving},
|
| 83 |
+
author={Zhibin Gou and Zhihong Shao and Yeyun Gong and yelong shen and Yujiu Yang and Minlie Huang and Nan Duan and Weizhu Chen},
|
| 84 |
+
year={2023},
|
| 85 |
+
eprint={2309.17452},
|
| 86 |
+
archivePrefix={arXiv},
|
| 87 |
+
primaryClass={cs.CL}
|
| 88 |
+
}
|
| 89 |
+
```
|