tree-of-thought-llm

让大模型像人类一样反复推敲,多路径思考找最优解

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 622 🐛 待处理 8 👀 关注 119
GitHub ↗
GitHub 星标 ★ 6089
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

tree-of-thought-llm 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队princeton-nlp
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型large-language-models,llm,prompting,tree-of-thoughts,tree-search
GitHub 星标★ 6089
上线时间2023-05-17 00:00:00
代码更新2025-01-16
仓库体积2.2 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

Tree of Thoughts (ToT) 是一个基于大语言模型的推理框架,源自 NeurIPS 2023 论文。它解决的是传统链式思维(CoT)在复杂问题中探索不足、易陷入局部最优的问题。核心能力是让模型在推理过程中生成多棵思维树,每棵树包含多个思考步骤,通过广度优先或深度优先搜索,结合评估函数对中间步骤打分,并支持回溯,从而找到最优推理路径。项目提供了完整的代码实现、示例场景(如24点游戏、创意写作、填字游戏)以及提示词模板,方便研究者复现和扩展。它特别适合需要多步推理、规划或探索的任务,能显著提升模型在复杂问题上的表现。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6089

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 4 步

环境要求

  • Python 环境且 pip 可用
  • OpenAI API Key(脚本默认使用 gpt-4)
  • 从源码安装需已安装 git
  • 网络可访问 PyPI 与 OpenAI 接口

安装与启动步骤

  1. 1设置 API Key

    把 OpenAI 密钥写入环境变量 OPENAI_API_KEY,代码运行时会自动读取;Windows 用 set 或 $env: 设置。

    export OPENAI_API_KEY=sk-xxxxxxxx
  2. 2从 PyPI 安装

    官方推荐方式之一,直接安装 tot 包,装完即可在脚本中 import tot。

    pip install tree-of-thoughts-llm
  3. 3从源码安装

    另一种安装方式,克隆仓库后装依赖并把本仓库以可编辑模式安装为 tot 包。

    git clone https://github.com/princeton-nlp/tree-of-thought-llm
    cd tree-of-thought-llm
    pip install -r requirements.txt
    pip install -e .
  4. 4编写并运行示例

    按 README Quick Start 编写最小脚本,用 GPT-4 求解 4 5 6 10 的 24 点问题,保存为 .py 后执行。

关键配置

配置项必填说明示例
OPENAI_API_KEY是代码读取的 OpenAI 密钥环境变量sk-xxxxxxxx
backend否示例脚本中选择的后端模型gpt-4
temperature否生成时的采样温度0.7
task否任务名,示例为 24 点游戏game24
method_generate否思维生成方法propose
method_evaluate否思维评估方法value

如何确认成功

运行示例脚本后打印出类似 10 - 4 = 6、Answer: (5 * (10 - 4)) - 6 = 24 的求解过程即成功。

常见问题

Q:没有 OpenAI API Key 能用吗?

A:README 只给出 OpenAI 后端的用法,安装后必须配置 OPENAI_API_KEY 环境变量才能运行示例。

Q:为什么每次结果不一样、有时还是错的?

A:README 明确说明输出不确定,有时会给出错误答案,属正常现象,需要自行核对结果。

Q:pip 安装 tot 包失败怎么办?

A:改用源码安装:git clone 仓库后执行 pip install -r requirements.txt 和 pip install -e .。

Q:运行很慢是什么原因?

A:README 提示该示例使用 GPT-4,速度可能偏慢,可耐心等待或改用更小的后端模型。

Q:可以解决哪些任务?

A:项目提供 24 点游戏、创意写作、填字游戏等示例场景及配套提示词模板。

注意事项

  • README 中的 Quick Start 脚本在节选里被截断,完整参数请以仓库源码为准。
  • 示例输出非确定性,可能出错,结果需人工校验后再使用。
  • API Key 建议按 OpenAI 官方安全实践存入环境变量,不要硬编码进代码。
  • 源码安装时需先 cd 进仓库目录,再执行 pip install -e . 安装 tot 包。

核心亮点

  • 基于NeurIPS 2023顶会论文,算法有理论支撑,权威性强
  • 实现多种搜索策略(BFS/DFS)和评估方法,灵活可配置
  • 提供24点、创意写作等示例,开箱即用,便于理解原理

不足之处

  • 对每个中间步骤都需要调用模型评估,计算成本高
  • 文档偏学术,上手门槛较高,缺少工程化封装

适用场景

  • 复杂数学推理题求解
  • 创意写作与故事生成
  • 需要规划或决策的智能体任务

替代项目

langchain、AutoGPT、思维树(ToT)的官方实现

上一篇:llm

下一篇:Edit-Banana

同类项目推荐

ruby-openai 开源

用 Ruby 轻松接入 OpenAI,一行代码调用 GPT-5

OpenAI API + Ruby! ❤️ GPT-5 & Realtime WebRTC compatible!

★ 3221 2026-08-09
cc-safety-net 开源

给 AI 编程代理装上安全刹车,拦截破坏性命令

A pre-execution guard for AI coding agents. It blocks destructive Git and file syste···

★ 1976 2026-08-12
ldp 开源

像换零件一样替换语言智能体的环境与优化器

Framework enabling modular interchange of language agents, environments, and optimiz···

★ 139 2026-10-13
openai-delphi 开源

用 Pascal 轻松接入 ChatGPT 和 DALL-E,让老语言焕发 AI 新活力。

OpenAI API client for Delphi and Lazarus/FPC. Use ChatGPT, DALL-E and other products···

★ 142 2026-08-09
Turing.jl 开源

用几行 Julia 代码写概率模型,自动完成贝叶斯推断

Bayesian inference with probabilistic programming.

★ 2263 2026-10-25
ollama-ai-provider-v2 开源

让 Vercel AI SDK 一键接入本地 Ollama 模型

Vercel AI Provider for running LLMs locally using Ollama

★ 105 2026-10-15
langgraph-trip-planner 开源

输入目的地和偏好,AI 自动生成完整旅行行程

Model-agnostic AI trip planner built with LangChain, LangGraph, FastAPI and Vue

★ 107 2026-09-25
req_llm 开源

Elixir 里统一调用各家大模型,管道式组合

Composable Elixir library for LLM interactions built on Req and Finch

★ 605 2026-09-16