ReasonGraph 快速上手指南

ReasonGraph 是一个开源 Web 平台，用于可视化和分析大语言模型（LLM）的推理过程。它支持将文本格式的推理输出转换为流程图，涵盖长程推理、元推理及多种主流推理方法（如思维链、树状搜索等）。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux / macOS / Windows
• Python 版本：推荐 3.11.8 (兼容 3.10+)
• 前置依赖：需安装以下 Python 库

python==3.11.8
requests==2.31.0
openai==1.63.2
together==1.4.1
flask==3.1.0
google==3.0.0
google-genai==1.2.0
google-generativeai==0.8.4

提示：国内开发者建议使用国内镜像源加速安装，例如阿里云或清华大学源。

安装步骤

1. 克隆项目代码 将仓库克隆到本地并进入根目录：

   git clone https://github.com/ZongqianLi/ReasonGraph.git
   cd ReasonGraph
   

2. 创建虚拟环境并安装依赖 推荐使用 venv 或 conda 隔离环境。以下以 pip 为例（使用清华源加速）：

   python -m venv venv
   # Linux/macOS:
   source venv/bin/activate
   # Windows:
   # venv\Scripts\activate
   
   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
   

   (注：若项目中无 requirements.txt，请根据上方“环境准备”中的列表手动安装对应包)

3. 配置 API Key 在项目根目录下找到或创建 api_keys.json 文件，填入您使用的模型服务商密钥。若不填写，界面可正常启动但无法进行推理调用。

   编辑 api_keys.json：

   {
       "anthropic": "<您的 Anthropic Key>",
       "openai": "<您的 OpenAI Key>",
       "google": "<您的 Google Key>",
       "together": "<您的 Together Key>"
   }
   

   支持的服务商：包括 Deepseek, Qwen, Grok 等（具体需在界面选择，部分可能复用上述通用接口或需在代码中扩展）。

基本使用

方式一：本地部署运行

1. 启动服务 在终端执行以下命令启动应用：

   python app.py
   

2. 访问界面 终端输出中将显示本地访问地址，例如：

    * Running on all addresses (0.0.0.0)
    * Running on http://127.0.0.1:5000
   

   在浏览器中打开该链接即可使用。

3. 功能演示

   • 长程推理可视化：选择模型（如 deepseek-reasoner），输入 Prompt，点击 "Long Reasoning" 即可生成推理路径图。
   • 多方法对比：可选择 Chain of Thoughts, Tree of Thoughts, Beam Search 等不同推理策略进行对比可视化。

方式二：在线体验（无需安装）

如果您希望快速体验而不想配置环境，可以直接访问 Hugging Face 上的在线 Demo：

• 地址：https://huggingface.co/spaces/ZongqianLi/ReasonGraph

在该页面中，您只需输入 API Key 即可立即开始可视化的推理实验。