lmnr

环境要求

• 已安装 Git
• 已安装 Docker 与 Docker Compose
• 如使用 JS/TS SDK 需 Node.js 与 npm 环境
• 如使用 Python SDK 需 Python 与 pip 环境
• 使用云端 SDK 追踪需先在 laminar.sh 创建项目并生成项目 API Key

安装与启动步骤

1. 1克隆项目仓库

   把 Laminar 仓库下载到本地并进入项目目录，后续所有 docker compose 命令都在此目录执行。

   git clone https://github.com/lmnr-ai/lmnr
   cd lmnr

   复制

2. 2docker compose 启动

   README 说明这是最快最简单的自托管方式，会拉起一套轻量但功能完整的服务栈。

   docker compose up -d

   复制

3. 3打开 Web UI

   浏览器访问本地 UI 地址，确认服务已运行。README 明确给出的端口是 5667。

4. 4配置 SDK 连接地址

   自托管还需要正确配置 SDK 的 baseUrl 和端口，README 指向官方的自托管指南文档，按文档填写。

5. 5安装 JS/TS SDK

   npm 安装会同时装上 Laminar TS SDK 以及 OpenAI、Anthropic、LangChain 等 instrumentation 包。

   npm add @lmnr-ai/lmnr

   复制

6. 6安装 Python SDK

   安装 Laminar Python SDK 及全部 instrumentation 包，适合 Python 应用接入追踪。

   pip install --upgrade 'lmnr[all]'

   复制

7. 7初始化并开始追踪

   在代码入口调用 Laminar.initialize 传入项目 API Key 即可自动追踪 LLM 调用，函数级别可用 observe 包装。

   import { Laminar } from '@lmnr-ai/lmnr';
   Laminar.initialize({ projectApiKey: process.env.LMNR_PROJECT_API_KEY });

   复制

8. 8生产环境部署

   README 建议生产环境使用托管平台，或改用完整版 compose 文件启动整套服务。

   docker compose -f docker-compose-full.yml up -d

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:5667 能正常加载 Laminar UI，即表示自托管服务启动成功。

常见问题

注意事项

• 只依据 README 提供的命令执行，README 未给出自托管的具体环境变量清单，baseUrl 与端口细节需查阅官方自托管文档。
• docker compose up -d 启动的是轻量版栈，适合快速开始或轻量使用，不等于完整生产部署。
• SDK 初始化需先创建项目并生成项目 API Key，代码示例中的 Key 需替换为你自己的值。
• 升级 ClickHouse 配置后原有日志表可能被重命名为带数字后缀的表（如 query_log_0），删除前请先确认。