langfuse

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 已注册 Langfuse Cloud 账号，或准备好自托管环境（需按官方 self-host 文档部署）
• Python 环境（可执行 pip），用于安装 Python SDK
• Node.js 环境（可执行 npm），用于安装 JS/TS SDK
• 待接入的 LLM 应用代码（如 LangChain、OpenAI SDK、LiteLLM 等）

安装与启动步骤

1. 1选择部署方式

   Langfuse 提供 Langfuse Cloud 托管服务与 Self Host 自托管两种方式，按团队运维能力选择其一。

2. 2注册云服务账号

   若选择托管方案，直接访问 Langfuse Cloud 注册即可开始使用，无需自己部署服务端。

3. 3查阅自托管文档

   若选择自托管，请按官方 self-host 文档操作；README 未给出具体部署命令，请勿凭猜测执行。

4. 4体验官方 Demo

   部署前可先打开官方 Demo 页面，了解追踪、评估、提示词管理等界面形态。

5. 5安装 Python SDK

   Python 项目通过 PyPI 上的 langfuse 包接入，命令在没有虚拟环境的终端中执行会装到全局。

   pip install langfuse

   复制

6. 6安装 JS/TS SDK

   TypeScript/JavaScript 项目通过 npm 上的 langfuse 包接入，注意在项目根目录执行。

   npm install langfuse

   复制

7. 7埋点并上报 Trace

   在你的应用中初始化 SDK 并埋点，让 LLM 调用、检索、嵌入、Agent 动作等逻辑上报到 Langfuse。

如何确认成功

运行应用后，在 Langfuse 界面中能看到新产生的 trace 记录，并能查看 LLM 调用日志与用户会话，即表示接入成功。

常见问题

注意事项

• README 节选未给出具体安装命令、端口与环境变量，自托管实际部署务必以官方 self-host 文档为准。
• 本教程中的 pip/npm 命令仅依据 README 标注的 PyPI 与 npm 包名推断，执行前建议核对官方文档。
• 自托管通常需配套数据库等依赖并由自己维护，请评估运维成本后再决定。
• 版本变更记录见 https://langfuse.com/changelog，升级前建议先阅读。