Python SDK

What's Changed

• perf(langchain): send trace updates on root span by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1284

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.2.2...v3.2.3

What's Changed

• feat(decorator): require langfuse_public_key only in top most decorated func by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1281
• docs: update readme and reference by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1260
• chore(deps): bump aiohttp from 3.10.11 to 3.12.14 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1258
• chore: add claude file by @nimarb in https://github.com/langfuse/langfuse-python/pull/1268
• chore(client): add check for tracing setting by @tim-hilde in https://github.com/langfuse/langfuse-python/pull/1269
• chore(types): fix mapvalue and init by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1271
• fix openai.py: when tool_call is a empty list, it raise an `list in… by @badbye in https://github.com/langfuse/langfuse-python/pull/1263
• chore: relax packaging constraint by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1273
• chore: reduce claude permissions by @nimarb in https://github.com/langfuse/langfuse-python/pull/1276
• fix: avoid private import of Langfuse to satisify Pyright by @janwinkler1 in https://github.com/langfuse/langfuse-python/pull/1275
• fix(client): parse env vars for debug and tracing enabled case insensitive by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1279

New Contributors

• @tim-hilde made their first contribution in https://github.com/langfuse/langfuse-python/pull/1269
• @badbye made their first contribution in https://github.com/langfuse/langfuse-python/pull/1263
• @janwinkler1 made their first contribution in https://github.com/langfuse/langfuse-python/pull/1275

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.2.1...v3.2.2

What's Changed

• chore: bump urllib3 by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1256
• chore: add mypy support by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1257
• fix(observe): wrap returned async generators by @kouk and @hassiebp in https://github.com/langfuse/langfuse-python/pull/1259

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.2.0...v3.2.1

What's Changed

• feat: add serialization of numpy ndarray by @marcklingen in https://github.com/langfuse/langfuse-python/pull/1246
• feat(client): allow setting additional headers by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1248
• feat(client): allow setting separate tracerprovider by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1254
• feat(client): allow updating span/generation name by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1255
• fix(openai): allow setting trace_id and parent_observation_id by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1245
• fix(serializer): NaN to string rather than None by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1253
• fix(client): allow using get_trace_url without active span by @skekfab in https://github.com/langfuse/langfuse-python/pull/1251
• chore(deps-dev): bump llama-index-core from 0.12.25 to 0.12.41 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1247

New Contributors

• @skekfab made their first contribution in https://github.com/langfuse/langfuse-python/pull/1251

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.1.3...v3.2.0

What's Changed

• fix(media): do not mutate vertex media dict by @philipshurpik in https://github.com/langfuse/langfuse-python/pull/1243
• fix(flushing): flush interval to millis in SpanProcessor by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1244

New Contributors

• @philipshurpik made their first contribution in https://github.com/langfuse/langfuse-python/pull/1243

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.1.2...v3.1.3

What's Changed

• fix(langchain): do not stringify metadata unnecessarily by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1237
• chore: add good .env defaults by @nimarb in https://github.com/langfuse/langfuse-python/pull/1239
• fix(openai): add check for metadata NotGiven by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1240
• fix(scores): skip sampling if OTEL sampler not available by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1241
• fix(dataset-run-items): correctly typ datasetRunItems.list by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1242

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.1.1...v3.1.2

What's Changed

• fix(client): do not escape url param with httpx > 0.28 by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1236

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.1.0...v3.1.1

What's Changed

• feat(prompts): chat message placeholders by @nimarb in https://github.com/langfuse/langfuse-python/pull/1222

New Contributors

• @nimarb made their first contribution in https://github.com/langfuse/langfuse-python/pull/1222

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.9...v3.1.0

What's Changed

• fix(openai): chat completions parse out of beta (sdk-v2) by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1232

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v2.60.8...v2.60.9

What's Changed

• feat(langchain): add last trace id property to CallbackHandler by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1230
• fix(openai): chat.completions.parse out of beta by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1231

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.7...v3.0.8

What's Changed

• fix(client): auth check on missing credentials by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1224
• fix(flushing): rely on OTEL default flush settings by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1229

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.6...v3.0.7

What's Changed

• fix(prompts): escape json in get_langchain_prompt by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1226

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.5...v3.0.6

What's Changed

• feat(client): allow filtering spans by instrumentation scope name by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1223
• fix(observe): default IO capture on decorated functions by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1221

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.4...v3.0.5

What's Changed

• fix(client): use tracing_enabled in get_client by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1220

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.3...v3.0.4

What's Changed

• fix(client): correctly scope client in multiproject setups by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1218
• chore(deps): bump protobuf from 5.29.4 to 5.29.5 by @dependabot in https://github.com/langfuse/langfuse-python/pull/1216

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.2...v3.0.3

What's Changed

• fix: set timeout to 5 seconds by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1211
• chore(deps): bump requests from 2.32.3 to 2.32.4 by @dependabot in https://github.com/langfuse/langfuse-python/pull/1209
• feat(langchain): langfuse trace attributes in run invocation config by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1213
• fix(client): url encoding slashes by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1214
• fix(resource-manager): do not register processor if tracing disabled by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1215

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.1...v3.0.2

What's Changed

• fix: treat usage_metadata.total_token_count of vertex ai as total by @gion-pop in https://github.com/langfuse/langfuse-python/pull/1208
• fix(client): scope mask function to resources singleton by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1210

New Contributors

• @gion-pop made their first contribution in https://github.com/langfuse/langfuse-python/pull/1208

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.0...v3.0.1

What's Changed

This is the new OTEL-based Langfuse Python SDK. See the our changelog post for more details and let us know your feedback in this GitHub Discussion.

Learn more

• Complete Migration Guide
• Python SDK v3 Documentation
• OpenTelemetry Integration Examples

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.0.0b4...v3.0.0b5