whatisgithub

What is toolbench?

openbmb/toolbench — explained in plain English

Analysis updated 2026-06-26

5,637PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

In one sentence

ToolBench is an AI research dataset and open-source model that teaches language models to use real software APIs, with over 16,000 APIs and 126,000 training examples showing step-by-step tool selection and reasoning.

Mindmap

mindmap
  root((repo))
    What it does
      API tool training
      Dataset creation
      Model fine-tuning
    Dataset
      16000 APIs
      126000 examples
      DFSDT method
    Models
      ToolLLaMA 7B
      ChatGPT baseline
      StableToolBench
    Research
      ICLR 2024 paper
      ToolEval benchmark
      Apache 2 license
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Fine-tune your own language model on tool-use examples using the ToolBench dataset to improve its ability to call real APIs

USE CASE 2

Evaluate how well any AI model performs at selecting and chaining API calls using the ToolEval benchmark framework

USE CASE 3

Research how AI agents reason step by step to complete complex tasks by exploring the DFSDT training data

USE CASE 4

Test tool-calling models in a reproducible way using StableToolBench, which replaces live API calls with simulated responses

What is it built with?

PythonPyTorchLLaMA

How does it compare?

openbmb/toolbenchrmax/scrapy-redisdmunozv04/isponsorblocktv
Stars5,6375,6345,632
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity4/53/53/5
Audienceresearcherdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a ToolBench API key to access the RapidAPI backend, plus Python environment setup, dataset download, and GPU for model fine-tuning.

Apache 2.0 license, use, modify, and distribute freely including for commercial purposes, as long as you include the copyright and license notice.

So what is it?

ToolBench is a research project from OpenBMB that teaches AI language models how to use real-world software tools and APIs. An API is a way for one piece of software to call another, for example a weather service, a translation tool, or a payment system. The project gathers over 16,000 such APIs from a platform called RapidAPI and builds a large dataset of tasks that require an AI to pick the right tools and call them in the right order. The core of the project is a dataset of about 126,000 examples, each showing an AI working through a task step by step: which tools to call, what results they returned, and how the AI reasoned about what to do next. To build this dataset automatically, the team created a method called DFSDT (depth-first search decision tree), which lets an AI explore different sequences of tool calls until it finds one that works. This process was run using ChatGPT and then filtered by the researchers. On top of the dataset, the project ships ToolLLaMA, an open-source language model fine-tuned on the ToolBench data. ToolLLaMA-2-7b-v2 is the current recommended version and shows tool-use performance comparable to ChatGPT. There is also an evaluation framework called ToolEval for measuring how well any model performs at using tools, and a companion project called StableToolBench that replaces live API calls with simulated responses so tests are more reproducible. This is primarily a research artifact accepted at the ICLR 2024 conference. Running it requires downloading the dataset, setting up the Python environment with the provided scripts, and in some cases obtaining a ToolBench API key to access the backend RapidAPI service. It is released under the Apache 2.0 license for research and educational use. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
How do I download the ToolBench dataset and fine-tune a LLaMA model on it to improve API tool-use? Walk me through the environment setup and training script.
Prompt 2
I want to evaluate my language model on the ToolEval benchmark from ToolBench. How do I set up the evaluation pipeline and what metrics does it report?
Prompt 3
How does the DFSDT method in ToolBench work to generate training data by having an AI explore different sequences of API calls until one succeeds?
Prompt 4
I want to use StableToolBench instead of live RapidAPI calls so my experiments are reproducible. How do I configure ToolBench to use the simulated API backend?
Prompt 5
What is ToolLLaMA-2-7b-v2 and how does its tool-use performance compare to ChatGPT on the ToolBench evaluation tasks?

Frequently asked questions

What is toolbench?

ToolBench is an AI research dataset and open-source model that teaches language models to use real software APIs, with over 16,000 APIs and 126,000 training examples showing step-by-step tool selection and reasoning.

What language is toolbench written in?

Mainly Python. The stack also includes Python, PyTorch, LLaMA.

What license does toolbench use?

Apache 2.0 license, use, modify, and distribute freely including for commercial purposes, as long as you include the copyright and license notice.

How hard is toolbench to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is toolbench for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.