ChatTutor

抽象概念画成图，边看边学，再难的知识也秒懂

ChatTutor 是一款可视化、互动式的 AI 辅导工具，将抽象的学习内容转化为直观的图形化界面，支持实时交互问答，帮助学习者在轻松的氛围中快速理解知识点，让自学不再枯燥。

开源 unknown 学习教育

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1316

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类学习教育

开发团队HugeCatLab

所属国家

官网地址https://chattutor.app

GitHubhttps://github.com/HugeCatLab/ChatTutor

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议AGPL-3.0

主要语言Vue

技术栈/模型ai,ai-education,education,llm,stem

GitHub 星标★ 1316

30天Star增速

HF 下载量

上线时间2025-11-05 00:00:00

最近更新2026-09-21 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 20 分钟部署方式：Docker 6 步

环境要求

本机已安装 Docker 与 Docker Compose（Docker 方式）
本机已安装 Node.js 与 pnpm（Node & Bun 方式）
一个可用的 PostgreSQL 数据库连接串（DATABASE_URL）
AI 服务的 API Key（MODEL_API_KEY）

安装与启动步骤

1克隆项目仓库

把 ChatTutor 源码拉到本地，命令执行完后会生成 ChatTutor 目录。
```
git clone https://github.com/HugeCatLab/ChatTutor.git
cd ChatTutor
```
2生成环境变量文件

从仓库自带的 .env.example 复制出 .env，后续所有配置都写在 .env 中。
```
cp .env.example .env
```
3填写数据库与模型配置

至少填好 DATABASE_URL、MODEL_API_KEY、AGENT_MODEL、AGENT_MODEL_PROVIDER，否则服务无法对话。
4可选填写 OSS 配置

需要图片上传才填 OSS_* 五项；不填则图片上传功能不可用，其余功能不受影响。
5用 Docker 启动服务

进入 docker 目录后以后台方式拉起容器，首次会拉取镜像，耗时较长。
```
cd docker
docker compose up -d
```
6（可选）Node & Bun 方式装依赖

不走 Docker 时，回到项目根目录执行依赖安装；README 未给出后续启动命令，需自行查阅仓库文档。
```
cd ChatTutor
pnpm i
```

关键配置

配置项	必填	说明	示例
`DATABASE_URL`	是	PostgreSQL 连接字符串，服务的数据存储依赖它	`postgresql://postgres:password@localhost:5432/chattutor`
`MODEL_API_KEY`	是	AI 服务商的 API 密钥	`sk-xxxxxxxxxxxxxxxx`
`MODEL_BASE_URL`	否	AI 服务地址，不填默认走 OpenAI	`https://api.openai.com/v1`
`AGENT_MODEL`	是	与用户对话的主 Agent 所用模型	`gpt-4`
`AGENT_MODEL_PROVIDER`	是	模型服务商，取值参见 README 的 Provider Enum	`openai`
`TITLE_MODEL`	否	生成会话标题的模型，默认等于 AGENT_MODEL	`gpt-4`

如何确认成功

执行 docker compose ps 确认容器处于运行状态，并用 docker compose logs 检查启动日志无报错；也可先访问官网验证功能效果。

常见问题

Q：没有 API Key 能用吗？

A：可以先用官网 https://chattutor.app 体验，在 https://chattutor.app/settings 里填写自己的 API Key 和模型即可，无需本地部署。

Q：图片上传为什么用不了？

A：README 明确说明未设置 OSS_ENDPOINT 等 OSS 变量时，图片上传功能不可用，补齐 OSS 五项配置即可恢复。

Q：模型服务商怎么选？

A：由 AGENT_MODEL_PROVIDER 指定，可选值需参考 README 中的 Provider Enum 列表；不填 MODEL_BASE_URL 时默认使用 OpenAI。

Q：除了 Docker 还能怎么跑？

A：README 还提供了 Node & Bun 方式，在项目根目录执行 pnpm i 安装依赖，但未给出后续启动命令，需要自行查看仓库文档。

Q：会话标题模型必须单独配吗？

A：不必，TITLE_MODEL 与 TITLE_MODEL_PROVIDER 都是可选项，默认沿用 AGENT_MODEL 和 AGENT_MODEL_PROVIDER。

注意事项

README 未提供默认访问端口和访问地址，启动后请以容器日志或仓库文档为准。
Node & Bun 方式的启动命令在 README 中缺失，只能确认到 pnpm i 这一步，请勿臆测启动参数。
官网可直接体验，建议先在官网配置好自己的 API Key 和模型，再决定是否本地部署。

核心亮点

基于Vue构建，交互式可视化AI辅导界面，提升学习体验
集成LLM技术，支持STEM教育场景，具备实际教学应用潜力
项目活跃度较高，星标数达1299，社区关注度持续增长

不足之处

文档/社区待观察

适用场景

学生自主学习和课后辅导
教师辅助教学和课堂互动
STEM领域知识问答与练习

替代项目

Khan Academy、OpenAI Tutor、Moodle

项目介绍

ChatTutor 是学习教育领域的开源项目，由 HugeCatLab 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,316）位列前 30%，在学习教育分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-21。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：学生自主学习和课后辅导。同类可对比的替代方案包括 Khan Academy、OpenAI Tutor、Moodle。

上一篇：ai-office-workshop

下一篇：human-skill-tree