Latitude-LLM 本地开发环境搭建指南

Latitude-LLM 本地开发环境搭建指南

latitude-llm Latitude is the open-source prompt engineering platform to build, evaluate, and refine your prompts with AI 项目地址: https://gitcode.com/gh_mirrors/la/latitude-llm

前言

Latitude-LLM 是一个基于现代技术栈构建的大型语言模型应用平台。本文将详细介绍如何在本地搭建完整的开发环境，帮助开发者快速开始项目开发与测试工作。

环境准备

在开始之前，请确保您的开发机器满足以下基本要求：

必备工具

1. Docker 环境：建议安装 Docker Desktop 或 Docker Engine 最新稳定版
2. Node.js 环境：推荐使用 LTS 版本（16.x 或更高）
3. 包管理工具：项目使用 pnpm 作为主要包管理器
4. 版本控制：Git 客户端工具

可选工具（推荐）

• Tmux 和 Tmuxinator：用于管理多个终端会话，特别适合同时运行多个服务
• 数据库客户端：如 TablePlus 或 DBeaver，方便查看数据库状态

详细搭建步骤

1. 获取项目代码

首先需要将项目代码克隆到本地开发环境：

git clone <项目仓库地址>
cd latitude-llm

2. 安装项目依赖

使用 pnpm 安装所有必要的依赖项：

pnpm install

3. 构建核心包

项目采用 monorepo 结构，需要先构建共享的核心包：

pnpm build --filter='./packages/**'

4. 环境配置

项目通常提供示例环境文件，需要根据实际情况调整：

cp .env.example .env

根据本地环境修改 .env 文件中的配置项，如数据库连接信息等。

5. 启动基础设施服务

使用 Docker Compose 启动数据库、消息队列等基础设施：

docker compose up -d

此命令会在后台启动所有定义在 docker-compose.yml 中的服务。

6. 数据库迁移

当数据库服务启动后，需要执行数据库迁移：

cd packages/core
pnpm db:migrate
cd ../..

7. 启动前端应用

开发模式下启动 Next.js 前端应用：

pnpm dev --filter web

开发环境使用指南

访问应用

1. Web 界面：浏览器访问 http://localhost:3000
2. 邮件服务：开发环境通常集成邮件模拟服务，访问 http://localhost:8025 查看发送的邮件
3. API 接口：API 服务通常运行在 http://localhost:3001（具体端口请参考配置）

常用开发命令

• 运行测试：pnpm test
• 代码格式化：pnpm format
• 类型检查：pnpm typecheck

高级配置

自定义 Docker 配置

如需修改服务配置，可以编辑 docker-compose.yml 文件，常见修改包括：

• 服务端口映射
• 资源限制（CPU/内存）
• 数据卷挂载路径

环境变量管理

项目使用分层环境变量系统：

1. .env：全局共享变量
2. apps/web/.env：前端特定变量
3. packages/core/.env：核心服务变量

开发技巧

使用 REPL 交互环境

项目提供了方便的 REPL 环境，可以直接与数据库等后端服务交互：

pnpm console

在 REPL 中可以执行如下的示例查询：

// 查询用户表前10条记录
await database.select().from(users).limit(10)

调试建议

1. 前端调试：使用 Chrome DevTools 的 React 开发者工具
2. 后端调试：配置 VS Code 的调试器连接到 Node.js 进程
3. 数据库调试：使用 GUI 工具直接查看数据库状态

环境清理

完成开发后，可以停止并清理环境：

docker compose down

如需完全清理，可以添加 -v 参数删除数据卷。

结语

通过本文的指导，您应该已经成功搭建了 Latitude-LLM 的本地开发环境。接下来可以开始探索项目代码结构，进行功能开发和问题修复。建议从简单的功能模块入手，逐步熟悉整个系统的架构设计。

latitude-llm Latitude is the open-source prompt engineering platform to build, evaluate, and refine your prompts with AI 项目地址: https://gitcode.com/gh_mirrors/la/latitude-llm