WorkflowsMay 12, 2026·2 min read

Langfuse Python SDK — Trace LLM Apps

Langfuse Python SDK adds tracing and observability to any LLM app via decorators or low-level calls, so you can track latency, cost, and prompts.

Agent Toolkit
Agent Toolkit · Community
Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Native · 94/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Cli
Install
Single
Trust
Trust: Established
Entrypoint
pip install langfuse
Universal CLI install command
npx tokrepo install 4bc8615f-82d2-5ecf-8842-720c8188357d
install contractmetadata JSONadapter planraw content
Intro

Langfuse Python SDK adds tracing and observability to any LLM app via decorators or low-level calls, so you can track latency, cost, and prompts.

  • Best for: Python LLM apps that need reliable tracing across prompts, tools, and providers
  • Works with: Python; decorators or low-level events; works with any LLM/provider (per README)
  • Setup time: 5–20 minutes

Practical Notes

  • Per README: SDK v4 rewrite shipped in March 2026 (check the v4 migration guide before upgrading).
  • Start with one endpoint/function, then expand tracing to tool calls and background jobs.
  • Log only what you can keep: scrub secrets and PII in prompts/responses before shipping traces.

Main

How to use it without over-instrumenting:

  1. Pick one “golden path” flow (a user question → tool calls → final answer).
  2. Add tracing at the boundaries: request in, model call out, tool call out, response back.
  3. Record inputs/outputs + timings first. Only add extra metadata (user IDs, tags, datasets) after the baseline works.
  4. Create a simple “regression dashboard”: slowest traces, highest error rate, and largest prompt payloads.

The fastest win is spotting which step burns tokens (retrieval, tool results, or prompt templates) and then trimming that step only.

FAQ

Q: Do I need a specific model/provider? A: No—README says it works with any LLM or framework; focus on consistent trace context instead of vendor-specific fields.

Q: Should I log full prompts? A: Only if allowed. Prefer redaction + sampling for sensitive environments; keep enough context to reproduce failures.

Q: What breaks during upgrades? A: SDK major rewrites can change event shapes. Follow the v4 migration guide before upgrading production services.

🙏

Source & Thanks

Source: https://github.com/langfuse/langfuse-python > License: MIT > GitHub stars: 399 · forks: 266

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

RagaAI Catalyst — LLM Eval + Tracing SDK

RagaAI Catalyst is a Python SDK for managing LLM projects with evaluation, dataset management, trace/agentic tracing, and prompt/guardrail workflows.

Workflows
Agent Toolkit

Weave — Trace and Debug LLM Apps

Weave adds tracing to LLM apps with `@weave.op`. Install `weave`, call `weave.init()`, then track inputs/outputs across API calls and validation steps.

Knowledge
Agent Toolkit

Langfuse — Open Source LLM Observability

Langfuse is an open-source LLM engineering platform for tracing, prompt management, evaluation, and debugging AI apps. 24.1K+ GitHub stars. Self-hosted or cloud. MIT.

Configs
Langfuse

openai-python — Official OpenAI Python SDK

Call the OpenAI REST API from Python 3.9+ with typed request/response models and sync/async clients. Use it as a core SDK for agents and app backends.

Scripts
Agent Toolkit
◈Home🔍Search👤Me