NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #655 most downloaded on PyPI
Langfuse Python SDK - LLM observability/tracing, datasets, experiments, LLM-as-a-judge evaluation, and prompt management
Latest stable
5.2.0
Last release 17 days ago
05 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
3 years old
562 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
feat(api): update API spec from langfuse/langfuse 618aac2 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/2089
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v5.1.0...v5.2.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
fix(openai): preserve audio data in provider responses by @HuaTNA in https://github.com/langfuse/langfuse-python/pull/2029
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v5.0.4...v5.1.0
fix(langchain): clean up streaming run memo on error by @dhionson2 in https://github.com/langfuse/langfuse-python/pull/1978
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v5.0.3...v5.0.4
chore(deps): bump the github-actions group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/2
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v5.0.2...v5.0.3
test: expect flattened metadata keys for v5 by @hassiebp in https://github.com/langfuse/langfuse-python/pull/2001
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v5.0.1...v5.0.2
Changelog and migration guide: https://langfuse.com/docs/observability/sdk/upgrade-path/python-v4-to-v5
Changelog and migration guide: https://langfuse.com/docs/observability/sdk/upgrade-path/python-v4-to-v5
docs(api): document metadata is set / is not set filter operators by @niklassemmler in https://github.com/langfuse/langfuse-python/pull/1946
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.17.0...v4.18.0
chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1915
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.16.0...v4.17.0
chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1903
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.6...v4.16.0
fix(openai): capture reasoning_effort and verbosity in model parameters by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1900
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.5...v4.15.6
fix(serializer): sanitize NaN/Inf nested in converted containers by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1878
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.4...v4.15.5
chore(deps): bump the github-actions group with 3 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1883
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.3...v4.15.4
chore(deps): bump zizmorcore/zizmor-action from 0.6.2 to 0.6.3 in the github-actions group across 1 directory by @dependabot[bot] in https://github.co
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.2...v4.15.3
chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1847
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.1...v4.15.2
feat(api): update API spec from langfuse/langfuse 74ded7e by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1844
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.15.0...v4.15.1
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.6...v4.15.0
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.6...v4.15.0
feat(api): update API spec from langfuse/langfuse 8ab6c91 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1835
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.5...v4.14.6
fix(serializer): handle NaN/Inf floats nested in pydantic models by @Shailendra005 in https://github.com/langfuse/langfuse-python/pull/1811
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.4...v4.14.5
chore(deps): bump the github-actions group with 3 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1804
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.3...v4.14.4
chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1801
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.2...v4.14.3
feat(api): update API spec from langfuse/langfuse b0387f7 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1770
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.1...v4.14.2
chore(deps): bump astral-sh/setup-uv from 8.2.0 to 8.3.0 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-pytho
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.14.0...v4.14.1
chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1746
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.13.2...v4.14.0
fix(openai): handle null choices in chat completion responses by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1745
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.13.1...v4.13.2
feat(api): update API spec from langfuse/langfuse 811f641 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1738
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.13.0...v4.13.1
chore(deps): bump zizmorcore/zizmor-action from 0.5.6 to 0.5.7 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.12.0...v4.13.0
feat(tracing): propagate environment attributes by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1726
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.11.0...v4.12.0
fix(langchain): avoid duplicating structured tool inputs in metadata by @milanagm in https://github.com/langfuse/langfuse-python/pull/1722
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.10.0...v4.11.0
fix(langchain): mark handled tool errors as errors by @vismaytiwari in https://github.com/langfuse/langfuse-python/pull/1718
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.9.1...v4.10.0
fix(openai): preserve Responses tools and streamed tool calls by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1715
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.9.0...v4.9.1
feat(api): update API spec from langfuse/langfuse 53433e8 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1712
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.8.1...v4.9.0
feat(api): update API spec from langfuse/langfuse 9ce4aa4 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1685
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.7.1...v4.8.1
feat(api): update API spec from langfuse/langfuse 9ce4aa4 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1685
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.7.1...v4.8.0b1
feat(api): update API spec from langfuse/langfuse 41f5847 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1677
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.7.0...v4.7.1
chore: add CODEOWNERS for GitHub config by @wochinge in https://github.com/langfuse/langfuse-python/pull/1652
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.6.1...v4.7.0
chore: improve agent development setup by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1642
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.5.1...v4.6.1
chore: improve agent development setup by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1642
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.5.1...v4.6.0b1
ci: allow prerelease branch releases by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1647
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.6.0b1...v4.6.0a1
chore(ci): pin action version comments to immutable patch tags by @wochinge in https://github.com/langfuse/langfuse-python/pull/1636
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.5.0...v4.5.1
fix(ci): disable zizmor advanced security to unblock releases by @wochinge in https://github.com/langfuse/langfuse-python/pull/1630
fetch-metadata version comment by @wochinge in https://github.com/langfuse/langfuse-python/pull/1633Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.3.1...v4.5.0
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
feat(api): update API spec from langfuse/langfuse 07cae52 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1617
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.2.0...v4.3.1
feat(api): update API spec from langfuse/langfuse 07cae52 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1617
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.2.0...v4.3.0rc1
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
chore(ci): move to blacksmith runners by @nimarb in https://github.com/langfuse/langfuse-python/pull/1613
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.6...v4.1.0
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
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.5...v4.0.6
build: set exclude-newer to 7 days by @wochinge in https://github.com/langfuse/langfuse-python/pull/1595
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.4...v4.0.5
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
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
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.2...v4.0.3
fix(openai): correct token details field names for Response API usage by @zachrobo1 in https://github.com/langfuse/langfuse-python/pull/1564
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.1...v4.0.2
feat(api): update API spec from langfuse/langfuse e84ca45 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1562
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.0...v4.0.1
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
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v4.0.0
Please see the preview migration guide for full details.
Please see the preview migration guide for full details.
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v4.0.0b1
feat(scores): support text scores in v3 by @wochinge in https://github.com/langfuse/langfuse-python/pull/1661
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.6...v3.15.0
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
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v3.14.6
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
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
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
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
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.1...v3.14.2
feat(dataset-versioning): support running versioned experiments by @marliessophie in https://github.com/langfuse/langfuse-python/pull/1517
Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.0...v3.14.1
One column per quarter.