Python SDK

What's Changed

• fix(ci): disable zizmor advanced security to unblock releases by @wochinge in https://github.com/langfuse/langfuse-python/pull/1630

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.3.1...v4.4.0b1

What's Changed

• feat(api): update API spec from langfuse/langfuse 07cae52 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1617
• chore(deps): bump actions/github-script from 8.0.0 to 9.0.0 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1616
• refactor(tests): split suites by execution level and speed up CI by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1609
• ci: add 7-day dependabot cooldown by @wochinge in https://github.com/langfuse/langfuse-python/pull/1619
• ci: harden GitHub Actions workflows with zizmor by @wochinge in https://github.com/langfuse/langfuse-python/pull/1623
• ci: make uv action tag explicit by @wochinge in https://github.com/langfuse/langfuse-python/pull/1625
• fix(langchain): propagate trace name metadata by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1626

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.2.0...v4.3.1

What's Changed

• feat(api): update API spec from langfuse/langfuse 07cae52 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1617
• chore(deps): bump actions/github-script from 8.0.0 to 9.0.0 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1616
• refactor(tests): split suites by execution level and speed up CI by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1609
• ci: add 7-day dependabot cooldown by @wochinge in https://github.com/langfuse/langfuse-python/pull/1619
• ci: harden GitHub Actions workflows with zizmor by @wochinge in https://github.com/langfuse/langfuse-python/pull/1623

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.2.0...v4.3.0rc1

What's Changed

• feat(client): add custom span exporter support by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1618

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.1.0...v4.2.0

What's Changed

• chore(ci): move to blacksmith runners by @nimarb in https://github.com/langfuse/langfuse-python/pull/1613
• feat(api): update API spec from langfuse/langfuse 1999706 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1615

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.6...v4.1.0

What's Changed

• chore(deps): bump langchain-core from 1.2.21 to 1.2.22 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1601
• feat(langchain): mark LangChain root observations in metadata by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1604

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

What's Changed

• chore(deps-dev): bump werkzeug from 3.1.5 to 3.1.6 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1531
• chore: upgrade ruff + merge configurations by @akx in https://github.com/langfuse/langfuse-python/pull/1535
• fix(media): reuse httpx client for requests by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1537
• feat(langchain): backport Langchain root metadata flag to v3-stable by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1605

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v3.14.6

What's Changed

• build: set exclude-newer to 7 days by @wochinge in https://github.com/langfuse/langfuse-python/pull/1595
• ci(dependabot): add github-actions ecosystem with grouped updates by @wochinge in https://github.com/langfuse/langfuse-python/pull/1597
• ci: pin and bump GH actions by @wochinge in https://github.com/langfuse/langfuse-python/pull/1596
• chore(deps): bump the github-actions group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1599
• fix(experiments): fix unstable local experiment IDs for local data by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1600

New Contributors

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

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

What's Changed

• chore: migrate repo from poetry to uv by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1589

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

What's Changed

• chore(deps-dev): bump langchain-core from 1.2.11 to 1.2.22 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1586
• fix(langchain): exit propagation context gracefully by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1588

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

What's Changed

• fix(openai): correct token details field names for Response API usage by @zachrobo1 in https://github.com/langfuse/langfuse-python/pull/1564
• fix(openai): include responses instructions in captured prompt by @D-Joey-G in https://github.com/langfuse/langfuse-python/pull/1565
• fix(observe): Handle asyncio.CancelledError in exception blocks by @jinohkang-theori in https://github.com/langfuse/langfuse-python/pull/1566
• chore: relax packaging constraint to <27 by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1570
• feat(api): update API spec from langfuse/langfuse a6c38c6 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1574
• chore(deps): bump requests from 2.32.5 to 2.33.0 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1579
• fix(scores): parse session ID correctly by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1582
• chore: fix flaky langchain tests by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1584
• fix(experiments): maintain propagated context in async experiments by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1587

New Contributors

• @zachrobo1 made their first contribution in https://github.com/langfuse/langfuse-python/pull/1564
• @D-Joey-G made their first contribution in https://github.com/langfuse/langfuse-python/pull/1565
• @jinohkang-theori made their first contribution in https://github.com/langfuse/langfuse-python/pull/1566

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

What's Changed

• feat(api): update API spec from langfuse/langfuse e84ca45 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1562
• chore(deps-dev): bump orjson from 3.11.3 to 3.11.6 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1563
• feat(api): update API spec from langfuse/langfuse b3adfc3 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1567

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

Breaking changes and migration guide

Please see our documentation.

Other changes

• chore(deps-dev): bump werkzeug from 3.1.5 to 3.1.6 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1531
• chore: upgrade ruff + merge configurations by @akx in https://github.com/langfuse/langfuse-python/pull/1535
• fix(media): reuse httpx client for requests by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1537
• feat!: prepare v4 release by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1486
• feat(api): update API spec from langfuse/langfuse 784ab09 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1538
• fix(media): retry failed uploads by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1540
• feat(api): update API spec from langfuse/langfuse 25b5139 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1543
• chore(deps-dev): bump langgraph-checkpoint from 3.0.0 to 4.0.0 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1541
• feat(api): update API spec from langfuse/langfuse a93f65a by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1545
• fix(langchain): skip priority-tier keys when subtracting token detail counts by @Br1an67 in https://github.com/langfuse/langfuse-python/pull/1549
• fix(experiment): replace escaped newlines with actual newlines in format output by @Br1an67 in https://github.com/langfuse/langfuse-python/pull/1547
• fix(openai): remove unreachable None type assignments for OpenAI classes by @Br1an67 in https://github.com/langfuse/langfuse-python/pull/1546
• Add handling for invalid tool calls in CallbackHandler by @deershark in https://github.com/langfuse/langfuse-python/pull/1550
• fix: apply stricter early routing for base64 media to prevent SSE dat… by @MoonSangJin in https://github.com/langfuse/langfuse-python/pull/1544
• chore: unify logging usage by @akx in https://github.com/langfuse/langfuse-python/pull/1539
• fix(client): pass release variable to span clients by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1518
• feat(api): update API spec from langfuse/langfuse 2eaf041 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1556
• chore(deps-dev): bump langgraph from 1.0.9 to 1.0.10rc1 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1560

New Contributors

• @akx made their first contribution in https://github.com/langfuse/langfuse-python/pull/1535
• @Br1an67 made their first contribution in https://github.com/langfuse/langfuse-python/pull/1549
• @deershark made their first contribution in https://github.com/langfuse/langfuse-python/pull/1550
• @MoonSangJin made their first contribution in https://github.com/langfuse/langfuse-python/pull/1544

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

Breaking changes

Please see the preview migration guide for full details.

New Contributors

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

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v4.0.0b1

What's Changed

• feat(batch-evaluation): add trace tags and roll up scores to trace by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1530

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.4...v3.14.5

What's Changed

• fix(experiments): remove dataset version from run item request if None by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1529

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.3...v3.14.4

What's Changed

• fix(openai): parse finish_reason from chat completion stream by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1526

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.2...v3.14.3

What's Changed

• chore(deps-dev): bump langsmith from 0.4.37 to 0.6.3 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1519
• fix Evaluation docstring examples to use value=0 instead of value=None by @Tkgmuuuu in https://github.com/langfuse/langfuse-python/pull/1520
• feat(api): update API spec from langfuse/langfuse 270f036 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1521
• chore(deps-dev): bump langchain-core from 1.2.5 to 1.2.11 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1523
• fix(openai): parse usage details from response API response chunk by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1525

New Contributors

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

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.1...v3.14.2

What's Changed

• feat(dataset-versioning): support running versioned experiments by @marliessophie in https://github.com/langfuse/langfuse-python/pull/1517

Requirements

• Running experiments requires v3.151.0 as of this version.

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.0...v3.14.1

What's Changed

• feat(api): update API spec from langfuse/langfuse 966662e by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1508

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.13.0...v3.14.0