From 30679471b39d22b2425189a25f7a22c1b560049d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sun, 13 Sep 2026 10:30:46 +0200 Subject: [PATCH 1/3] chore(deps): bump zizmorcore/zizmor-action from 0.6.2 to 0.6.3 in the github-actions group across 1 directory (#1865) chore(deps): bump zizmorcore/zizmor-action Bumps the github-actions group with 1 update in the / directory: [zizmorcore/zizmor-action](https://github.com/zizmorcore/zizmor-action). Updates `zizmorcore/zizmor-action` from 0.6.2 to 0.6.3 - [Release notes](https://github.com/zizmorcore/zizmor-action/releases) - [Commits](https://github.com/zizmorcore/zizmor-action/compare/3dc1ecc9bcb9e94e9b2c709687979e1298497054...70fb788f84895a7701f5643d103d587e460b5c99) --- updated-dependencies: - dependency-name: zizmorcore/zizmor-action dependency-version: 0.6.3 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: github-actions ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/zizmor.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/zizmor.yml b/.github/workflows/zizmor.yml index d3a700ff2..e23525e22 100644 --- a/.github/workflows/zizmor.yml +++ b/.github/workflows/zizmor.yml @@ -26,7 +26,7 @@ jobs: with: persist-credentials: false - name: Run zizmor - uses: zizmorcore/zizmor-action@3dc1ecc9bcb9e94e9b2c709687979e1298497054 # v0.6.2 + uses: zizmorcore/zizmor-action@70fb788f84895a7701f5643d103d587e460b5c99 # v0.6.3 with: advanced-security: ${{ github.event_name == 'push' && 'true' || 'false' }} min-severity: low From d6c50f1675b6118517454c1b773f74e32262108f Mon Sep 17 00:00:00 2001 From: Max Deichmann Date: Tue, 15 Sep 2026 15:56:49 +0200 Subject: [PATCH 2/3] docs: strengthen agent-facing README so v2 APIs are not treated as current (#1879) * docs: strengthen agent-facing README so v2 APIs are not treated as current Coding agents still use Langfuse().trace() and GET /api/public/traces after pip install langfuse. Put the current OTEL APIs, Observations/Metrics v2 links, and the 10-minute freshness SLO in the first screen of the README. Co-authored-by: Cursor * docs: restore the v4 rewrite note and keep Langfuse() as a current constructor Keep the March 2026 migration callout in the banner, drop Langfuse() from the deprecated v2 API list, and restore the previous PyPI description. Co-authored-by: Cursor --------- Co-authored-by: Cursor --- README.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 2b2fd9d41..35b3bb5e7 100644 --- a/README.md +++ b/README.md @@ -9,13 +9,21 @@ [![Discord](https://img.shields.io/discord/1111061815649124414?style=flat-square&logo=Discord&logoColor=white&label=Discord&color=%23434EE4)](https://discord.gg/7NXusRtqYU) [![YC W23](https://img.shields.io/badge/Y%20Combinator-W23-orange?style=flat-square)](https://www.ycombinator.com/companies/langfuse) +> [!IMPORTANT] +> The SDK was rewritten in v4 and released in March 2026. Refer to the [v4 migration guide](https://langfuse.com/docs/observability/sdk/upgrade-path/python-v3-to-v4) for instructions on updating your code. +> +> **This is the latest Langfuse Python SDK (v4, OpenTelemetry).** The legacy v2 client API (`trace()`, `span()`, `generation()`, `api.trace.list`) is **deprecated**. Do **not** use it for new instrumentation. +> +> **Latest Python SDK (OpenTelemetry):** `pip install langfuse`. Use `get_client()` + `start_as_current_observation` / `@observe`. Prompts/datasets/scores: the same `langfuse` package. Docs: https://langfuse.com/docs/observability/sdk/overview. Upgrade: [v2 to v3](https://langfuse.com/docs/observability/sdk/upgrade-path/python-v2-to-v3), [v3 to v4](https://langfuse.com/docs/observability/sdk/upgrade-path/python-v3-to-v4). +> +> Query traces with [Observations API v2](https://langfuse.com/docs/api-and-data-platform/features/observations-api) (`GET /api/public/v2/observations`, [API reference](https://api.reference.langfuse.com/#tag/observationsv2)), not `GET /api/public/traces` / `api.trace.list`. +> +> **Data freshness:** the only real-time path is OpenTelemetry ingestion (this SDK at `langfuse` >= 4.7.0, or any OTel exporter sending `x-langfuse-ingestion-version: 4`) combined with the [Observations API v2](https://langfuse.com/docs/api-and-data-platform/features/observations-api) and [Metrics API v2](https://langfuse.com/docs/metrics/features/metrics-api). All other GET APIs from all SDK versions can be up to 10 minutes behind. + The [Langfuse](https://langfuse.com) Python SDK covers the full platform: **observability/tracing** (OpenTelemetry-based, with OpenAI and LangChain integrations), **datasets & experiments** (offline evaluation and regression testing of prompt/model changes, including [CI via GitHub Actions](https://github.com/langfuse/experiment-action)), **LLM-as-a-judge and custom evaluations/scores**, **prompt management**, and a **full REST API client**. ## Installation -> [!IMPORTANT] -> The SDK was rewritten in v4 and released in March 2026. Refer to the [v4 migration guide](https://langfuse.com/docs/observability/sdk/upgrade-path/python-v3-to-v4) for instructions on updating your code. - ``` pip install langfuse ``` @@ -52,3 +60,5 @@ langfuse.flush() - Full documentation: https://langfuse.com/docs - Machine-readable docs index (for AI agents): https://langfuse.com/llms.txt - API reference of this package: https://python.reference.langfuse.com +- REST API reference (Observations API v2, Metrics API v2, Scores API v3): https://api.reference.langfuse.com +- Data freshness and real-time ingestion: https://langfuse.com/docs/compatibility#faq-delay From 49b8f9e7f2767295c7b61809e943813d202d10ee Mon Sep 17 00:00:00 2001 From: langfuse-bot Date: Tue, 15 Sep 2026 14:00:14 +0000 Subject: [PATCH 3/3] chore: release v4.15.3 --- pyproject.toml | 2 +- uv.lock | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/pyproject.toml b/pyproject.toml index 4475c24c0..882732dd3 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "langfuse" -version = "4.15.2" +version = "4.15.3" description = "Langfuse Python SDK - LLM observability/tracing, datasets, experiments, LLM-as-a-judge evaluation, and prompt management" readme = "README.md" authors = [{ name = "langfuse", email = "developers@langfuse.com" }] diff --git a/uv.lock b/uv.lock index 09bbfebd0..64f460677 100644 --- a/uv.lock +++ b/uv.lock @@ -3,7 +3,7 @@ revision = 3 requires-python = ">=3.10, <4.0" [options] -exclude-newer = "2026-09-02T16:01:13.524005949Z" +exclude-newer = "2026-09-08T14:00:09.934945824Z" exclude-newer-span = "P7D" [[package]] @@ -554,7 +554,7 @@ wheels = [ [[package]] name = "langfuse" -version = "4.15.2" +version = "4.15.3" source = { editable = "." } dependencies = [ { name = "backoff" },