zubingou commited on
Commit
cbb33ee
β€’
1 Parent(s): f8a2b42

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +89 -0
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>&dagger;</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>&dagger;</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
+ ```