文档运行项目启动项目

本地启动项目

在启动项目之前,你需要已经准备好了开发环境。这里作者使用最新版本的IDEA演示如何本地启动项目

Clone & Open

首先把整个项目代码下载到本地:

git clone https://github.com/tycoding/langchat.git

使用IDEA打开整个langchat项目文件夹:

下载依赖

前端

主要包含 langchat-uilangchat-ui-client 两个模块,需要用pnpm下载依赖

cd langchat-ui
pnpm install
 
cd langchat-ui-client
pnpm install

后端

IDEA打开后会自动加载Maven依赖,除了上面两个ui模块,其余模块都是后端的。

环境配置

Clone下来的代码,首先你需要修改后端SpringBoot项目的配置文件才能运行。

导入sql

你需要再MySQL8下创建一个名为langchat的数据库,然后在项目根目录找到langchat.sql脚本并导入表结构

修改application.yml

注意,application.yml中默认配置local环境,你可以在本地创建application-local.yml文件,当然也可以修改为dev环境使用application-dev.yml中的配置。

application-dev.yml包含了最基础的环境配置要求:

  1. 正常启动项目,必须配置好mysqlredis信息
  2. langchat.auth定义了后台管理系统超级管理员账号的登录信息,is-demo-dev为是否开启演示环境
  3. langchat.vectorstore定义了LLM向量库的信息,目前LangChat采用PgVector向量数据库
  4. langchat.web-search.google定义了谷歌搜索功能的key信息,这个看情况配置

另外:因为LLM大模型的配置是在前端动态配置的,因此不需要在配置文件中定义了,但是考虑到向量库一般不能轻易改变,因此vectorStore的配置仍放在配置文件中

启动后端项目

后端运行LangChatApp.java的main函数启动:

启动langchat-ui前端

前端基于Node,先安装依赖再启动项目,运行如下命令:

cd langchat-ui
 
pnpm install
 
pnpm run dev

启动后访问 http://localhost:3003/ 跳转到后台系统登录页

启动langchat-ui-client前端

前端基于Node,先安装依赖再启动项目,运行如下命令:

cd langchat-ui-client
 
pnpm install
 
pnpm run dev

启动后访问 http://localhost:1002/ 跳转到客户端系统首页