项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1359
使用教程
环境要求
- JDK 与 Maven(后端打包和 spring-boot:run 运行)
- Node.js 与 pnpm(corepack enable 启用,前端依赖与开发服务)
- MySQL 等数据库,需按 docs/db/langchat.sql 初始化
- Docker 与 Docker Compose(选择容器化部署时使用)
安装与启动步骤
-
1复制本地配置
把示例配置复制为本地配置,该文件已被 Git 忽略,用于保存本机真实连接信息,不会提交。
cp langchat-server/src/main/resources/application-local.example.yml langchat-server/src/main/resources/application-local.yml -
2填写数据库与密码
编辑 application-local.yml,填写数据库连接和本地管理员密码;生产环境改用环境变量,勿写入仓库。
-
3初始化数据库
使用仓库中的 docs/db/langchat.sql 脚本初始化数据库,连接信息需与上一步配置保持一致。
-
4安装前端依赖
进入前端目录启用 corepack 并安装依赖,构建脚本不会自动安装,首次构建前必须先执行。
cd langchat-ui corepack enable pnpm install cd .. -
5启动本地项目
以 local 环境变量启动统一入口脚本,脚本会拉起后端与前端服务。
SPRING_PROFILES_ACTIVE=local ./langchat.sh -
6Docker 部署
先 prepare 生成 docker/.env 与 docker/application-docker.yml,改好凭据后再执行 deploy 构建并启动。
bash build-docker.sh prepare bash build-docker.sh deploy
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
SPRING_PROFILES_ACTIVE | 是 | 指定 Spring 运行环境,本地启动使用 local | local |
spring.config.additional-location | 否 | 非 Docker 部署时加载外部真实配置文件 | /your/path/application-runtime.yml |
LANGCHAT_RELEASE_DIR | 否 | 修改 build-release.sh 交付目录输出位置 | /opt/releases/langchat |
LANGCHAT_DOCKER_ENV_FILE | 否 | 指定 Docker Compose 使用的环境变量文件 | docker/.env |
LANGCHAT_CONFIG_SOURCE | 否 | 指定相对 docker-compose.yml 的后端 YAML 配置 | application-docker.yml |
如何确认成功
前端访问 http://localhost:5888,后端访问 http://localhost:8080,健康检查 http://localhost:8080/actuator/health 正常返回。
常见问题
Q:build-release.sh 构建时报前端依赖缺失怎么办?
A:该脚本不会自动安装前端依赖,先在 langchat-ui 目录执行 pnpm install,再重新运行 bash build-release.sh。
Q:Docker 启动被拒绝,提示 change-me?
A:需先修改 docker/.env 与 docker/application-docker.yml,替换示例中的 change-me、默认密码和访问密钥,且两份配置凭据保持一致。
Q:application-local.yml 会被提交到仓库吗?
A:不会,该文件已加入 .gitignore,仅用于本机真实配置;生产环境请使用环境变量,不要提交密码或密钥。
Q:容器运行后如何查看日志或重启?
A:执行 bash build-docker.sh logs langchat 持续查看日志,bash build-docker.sh restart 重启 LangChat 应用容器。
注意事项
- 部署前必须替换示例中的 change-me、默认密码和访问密钥,build-docker.sh 会拒绝使用仍含 change-me 的配置启动。
- Docker 部署的数据库与 RustFS 凭据需在 docker/.env 和 docker/application-docker.yml 中保持一致。
- 不要直接修改并提交生产凭据,非 Docker 部署可用外部 YAML 或环境变量覆盖配置。
- 不要在 Issue、日志、提交记录或截图中公开 API Key、数据库密码和访问令牌。
核心亮点
- Java + Vue3 全栈技术栈,贴合国内企业内网部署与二次开发习惯
- 同时覆盖 Agent、RAG 知识库、Skills、MCP、智能问数,功能面较完整
- 基于 LangChain4j,多模型接入和工具调用有成熟生态支撑
不足之处
- 项目处于成长阶段,文档完整度和社区案例积累有限
- Vue 前端为主,若团队偏 React 或纯 Python 技术栈迁移成本较高
适用场景
- 企业内部知识库智能问答与客服机器人
- 基于数据库的自然语言智能问数(NL2SQL)
- 需要私有化部署、多模型切换的 AI Agent 应用搭建
替代项目
Dify、FastGPT
同类项目推荐
pisper
开源
多智能体并行干活,桌面终端手机都能用
Multi-agent app for parallel sessions, tools, memory, workflows, desktop, terminal, ···
Claude-Patent-Creator
开源
用AI自动写美国专利,检索+合规+附图一步到位
USPTO patent creation system with MCP server + Claude Code plugin. Hybrid RAG search···
sample-specship
开源
让 AI 编码代理按规范流程自主交付,质量有门禁
Spec-driven autonomous engineering workflow for AI coding agents: recon → plan → b···
FrontAgent
开源
让 AI 自主规划并完成前端开发任务,从代码补全到智能体协作。
Frontend AI coding agent platform with CLI, VS Code extension, desktop app, MCP serv···
deep-search-pro
开源
千行代码看懂多智能体协作搜索
Deep Search Pro —— 一个不到 1000 行的多智能体协作搜索系统。基于 LangChain + FastAP···
iran-mcp
开源
让 AI 智能体一键接入伊朗本地电商、招聘、地图等 77 个服务
77 MCP servers (994 tools) that give AI agents the Iranian web: Digikala, Torob, Div···
foxl-orchestrator
开源
让 Claude 帮你操作浏览器,24小时自动干活
Personal AI Agent Hub 2026 — Build Your 24/7 Autonomous Assistant
Awesome-Agentic-Reasoning
开源
一网打尽大模型智能体推理前沿论文,快速入门研究导航
A curated list of papers and resources based on the survey "Agentic Reasoning for La···
golf
开源
快速搭建生产级 MCP 服务器,安全部署 AI 智能体
Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infra···
