ChatTutor

可视化与交互式AI辅导老师

[!NOTE]

在线网站：ChatTutor 已在 https://chattutor.app 上线，请在设置中配置您自己的 API 密钥和模型。(https://chattutor.app/settings)

ChatTutor 是一款具备电子白板功能的 AI 辅导老师。

传统的聊天机器人主要通过文本与用户互动，在大多数场景下已足够。然而，随着近年来大语言模型的发展，越来越多的人开始使用 AI 来辅助学习。在真实的课堂环境中，教师会使用粉笔、电脑、黑板等多种教学工具来帮助学生更好地理解知识。但对于聊天机器人而言，仅靠文本传递的信息非常有限，尤其是在 STEM 学科领域。

ChatTutor 有效地解决了这一问题，它将现实教育场景中的各种教学工具引入到线上平台，使用户能够通过电子设备与这些工具进行交互。我们赋予了 AI 使用这些工具的能力，从而使 AI 成为一位真正可动手操作的老师。

功能

数学画布

思维导图

快速入门

git clone https://github.com/HugeCatLab/ChatTutor.git
cd ChatTutor
cp .env.example .env

cd docker
docker compose up -d

git clone https://github.com/HugeCatLab/ChatTutor.git
cd ChatTutor
pnpm i

pnpm dev

pnpm client:dev
pnpm web:dev

pnpm build
pnpm client:start
pnpm web:start

技术栈

• Geogebra
• Vue
• Vite
• ElysiaJs
• AI SDK

赞助商

我们的赞助商名单如下（不分先后）：

• AiHubMix：开放的 AI 模型中心。

星标历史

AGPL v3 许可证

版权所有 © 2025 Acbox，保留所有权利。

ChatTutor 快速上手指南

ChatTutor 是一款具备电子白板能力的可视化交互式 AI 导师。它突破了传统聊天机器人仅通过文本交互的限制，让 AI 能够像真实教师一样使用数学画布（Math Canvas）和思维导图（Mindmap）等工具进行教学，特别适用于 STEM 领域的学习辅助。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

方案一：使用 Docker（推荐）

• Docker: >= 24.0.0
• Docker Compose: >= 2.22.0

方案二：使用 Node.js & Bun

• Node.js: >= 20
• Bun: >= 1.2
• pnpm: >= 9.1.0
• 数据库: PostgreSQL (需自行准备连接字符串)

注意：您需要准备一个 AI 服务 API Key（支持 OpenAI, Anthropic, DeepSeek 等）。

安装步骤

1. 获取源码

git clone https://github.com/HugeCatLab/ChatTutor.git
cd ChatTutor

2. 配置环境变量

复制示例配置文件并根据实际情况修改：

cp .env.example .env

关键配置项说明（编辑 .env 文件）：

• DATABASE_URL: PostgreSQL 连接字符串
• MODEL_API_KEY: 您的 AI 服务 API Key
• AGENT_MODEL: 主对话模型名称 (例如 gpt-4)
• AGENT_MODEL_PROVIDER: 模型提供商 (openai, anthropic, 或 deepseek)
• OSS_*: 对象存储配置（若未配置将无法上传图片）

3. 启动服务

方式 A：使用 Docker 启动（最简单）

cd docker
docker compose up -d

方式 B：使用 Node/Bun 本地开发

安装依赖：

pnpm i

启动开发服务器：

pnpm dev

或者分别启动客户端和服务端：

pnpm client:dev
pnpm web:dev

生产环境构建与运行：

pnpm build
pnpm client:start
pnpm web:start

基本使用

1. 访问应用

   • 启动成功后，通常在浏览器访问 http://localhost:8001 (具体端口请参考启动日志或 .env 中的 CLINET_BASE_URL)。
   • 如果是 Docker 部署，请检查 docker-compose.yml 中映射的端口。

2. 配置模型

   • 进入应用后，前往设置页面 (Settings)。
   • 输入您的 API Key 并选择对应的模型提供商和模型名称。

3. 开始互动教学

   • 在对话框中输入问题，例如：“请帮我讲解勾股定理”或“画出神经网络的思维导图”。
   • 数学画布：AI 将自动调用 GeoGebra 引擎，在右侧画布上绘制函数图像或几何图形进行演示。
   • 思维导图：AI 可生成 Mermaid 格式的思维导图，帮助您梳理知识脉络。

现在，您可以像拥有私人助教一样，享受可视化的 AI 教学体验了。