ChatTutor-视觉化和互动式 AI 辅导员

在线网站：ChatTutor 可以通过

https://chattutor.app[1] 访问，请在设置中设置自己的 API 密钥和模型。设置链接[2]

简介

ChatTutor 是一款具备使用电子白板能力的 AI 教师。

传统的聊天机器人主要通过文本与用户互动，这在大多数场景下是足够的。然而，随着近年来大型语言模型（LLM）的发展，越来越多的人开始利用 AI 来辅助学习。在现实世界的课堂中，教师有许多教学工具——粉笔、计算机、黑板及其他教学辅助工具——这些工具帮助学生更好地理解知识。而对于聊天机器人来说，文本传递的信息非常有限，尤其是在 STEM（科学、技术、工程、数学）学科中。

ChatTutor 通过将现实教育场景中的所有教学工具带到前台，允许用户通过电子设备与这些工具互动，有效地解决了这个问题。我们赋予 AI 使用这些工具的能力，使其成为一个真正的动手实践型教师。

功能

•数学画布

数学画布功能使得用户可以在互动中进行数学相关的图形、公式等的绘制与计算。

•思维导图

帮助用户构建思维导图，组织和展示知识点之间的联系。

快速开始

环境变量

数据库配置

•DATABASE_URL: PostgreSQL 连接字符串

服务器和客户端

•VITE_API_BASE_URL: API 服务器的基础 URL（例如：http://localhost:8002）•CLINET_BASE_URL: 客户端应用的基础 URL（例如：http://localhost:8001）

AI 配置

•MODEL_API_KEY: 你的 AI 服务 API 密钥（例如：your_api_key_here）•MODEL_BASE_URL: AI 服务的基础 URL（可选，默认为 OpenAI）•AGENT_MODEL: 与用户聊天的主要代理模型（例如：gpt-4）•AGENT_MODEL_PROVIDER: 模型提供者（选项：参考 Provider 枚举）•TITLE_MODEL: 用于生成聊天标题的模型（可选，默认为 AGENT_MODEL）•TITLE_MODEL_PROVIDER: 标题生成的模型提供者（可选，默认为 AGENT_MODEL_PROVIDER，参考 Provider 枚举）

Provider 枚举

•OpenAI: openai•Anthropic: anthropic•DeepSeek: deepseek

OSS 配置

•OSS_ENDPOINT: OSS 终端节点 URL（如果未设置，将无法上传图片）•OSS_ACCESS_KEY: OSS 访问密钥•OSS_SECRET_KEY: OSS 秘密密钥•OSS_BUCKET: OSS 存储桶名称•OSS_REGION: OSS 区域

使用 Docker 运行

环境要求

•Docker>= 24.0.0•Docker Compose >= 2.22.0

设置

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

运行

cd docker
docker compose up -d

使用 Node 和 Bun 运行

环境要求

•Node.js >= 20•Bun >= 1.2•pnpm >= 9.1.0

设置

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

开发模式

pnpm dev

或者：

pnpm client:dev
pnpm web:dev

技术栈

•Geogebra•Vue•Vite•ElysiaJs•AI SDK

https://github.com/HugeCatLab/ChatTutor

References

[1] https://chattutor.app: https://chattutor.app/ [2] 设置链接: https://chattutor.app/settings