PostHog Python

Minor changes

• a2ce51e feat(feature-flags): support the early_exit condition option in local evaluation. When a flag enables early exit, evaluation now stops and returns False as soon as a condition group's property filters match but the rollout percentage excludes the user, instead of falling through to later groups — matching the server-side evaluation behavior. — Thanks @gustavohstrassburger!

Minor changes

• 3aed638 Add a configurable $is_server event property (default true) so PostHog can identify server-side events. Set is_server=False when using posthog-python as a client/CLI so the device OS is attributed normally. — Thanks @turnipdabeets for your first contribution 🎉!

Patch changes

• 44e6b14 Fix async streaming responses from the AI wrappers (OpenAI, Anthropic, Gemini) so they support async with as well as async for. Previously, consuming a stream via async with (e.g. with pydantic-ai) raised TypeError: 'async_generator' object does not support the asynchronous context manager protocol. — Thanks @turnipdabeets for your first contribution 🎉!

Patch changes

• 643a810 Return empty flag defaults from Client flag helpers when the flags API fails. — Thanks @marandaneto!

Patch changes

• 034dce2 Make module-level setup no-op when API key is blank — Thanks @marandaneto!

Patch changes

• 8f6d6c8 Include group context in the $feature_flag_called dedupe key so group-scoped flags fire a separate event for each group a user is evaluated under, instead of being dedup-ed against the first group context the same (distinct_id, flag, response) was seen under. — Thanks @gustavohstrassburger!

Minor changes

• a44e0be Add async flag definition cache providers — Thanks @dustinbyrne!

Patch changes

• 0207088 Track OpenAI chat completions parse calls — Thanks @marandaneto!

Patch changes

• be9b78b Reject semver values with leading zeros in local flag evaluation. Per semver 2.0.0 §2, numeric identifiers must not include leading zeros — values like 1.07.3 are not valid semver and should not match targeting conditions. Both override values and flag values are now validated; invalid inputs raise InconclusiveMatchError so the condition does not match. — Thanks @dmarticus!

Patch changes

• 1574b1b Fix OpenAI usage parsing when token detail fields are null — Thanks @michael-ciridae!

Patch changes

• a098aa7 Fix Gemini web search extraction when response candidates are null. — Thanks @marandaneto!

Minor changes

• 52cd20e feat: add Celery integration and improve PostHog client fork safety — Thanks @parinporecha!

Patch changes

• 44c1261 Fix scoped context support for async functions — Thanks @marandaneto!

Patch changes

• f6c8ede fix: type warning on new_context — Thanks @itsaphel for your first contribution 🎉!

What's Changed

• chore: remove unsupported setup-uv input by @marandaneto in https://github.com/PostHog/posthog-python/pull/545
• chore: commit generated references with GitHub App by @marandaneto in https://github.com/PostHog/posthog-python/pull/546
• feat: add evaluate_flags() API for single-call flag evaluation by @dmarticus in https://github.com/PostHog/posthog-python/pull/539

Full Changelog: https://github.com/PostHog/posthog-python/compare/7.13.2...7.14.0

What's Changed

• chore(deps): bump litellm from 1.83.0 to 1.83.7 in /examples/example-ai-dspy by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/536
• chore(deps): bump litellm from 1.81.13 to 1.83.7 in /examples/example-ai-litellm by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/535
• chore(deps): bump litellm from 1.74.9 to 1.83.7 in /examples/example-ai-crewai by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/537
• fix: remove python-dateutil runtime dependency by @marandaneto in https://github.com/PostHog/posthog-python/pull/540
• fix: sanitize Django tracing headers by @dustinbyrne in https://github.com/PostHog/posthog-python/pull/538
• fix: acknowledge oversized dropped events by @marandaneto in https://github.com/PostHog/posthog-python/pull/543
• fix: no-op clients without api key by @marandaneto in https://github.com/PostHog/posthog-python/pull/544
• fix: clarify feature flag auth errors by @marandaneto in https://github.com/PostHog/posthog-python/pull/542

Full Changelog: https://github.com/PostHog/posthog-python/compare/7.13.1...7.13.2

What's Changed

• chore(deps): bump python-dotenv from 1.1.1 to 1.2.2 by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/528
• chore(deps): bump python-dotenv from 1.1.1 to 1.2.2 in /examples/example-ai-crewai by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/529
• chore(deps): bump python-dotenv from 1.2.1 to 1.2.2 in /integration_tests/django5 by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/530
• chore: upgrade PostHog GitHub Action to v1 by @marandaneto in https://github.com/PostHog/posthog-python/pull/531
• feat(flags): support mixed targeting in local evaluation by @patricio-posthog in https://github.com/PostHog/posthog-python/pull/523

Full Changelog: https://github.com/PostHog/posthog-python/compare/7.13.0...7.13.1

What's Changed

• chore: use engineering@posthog.com in package metadata by @marandaneto in https://github.com/PostHog/posthog-python/pull/514
• feat(examples): add Dedalus Labs and Cloudflare AI Gateway examples by @richardsolomou in https://github.com/PostHog/posthog-python/pull/508
• feat(flags): implement get_feature_flag endpoint in SDK compliance adapter by @andehen in https://github.com/PostHog/posthog-python/pull/500
• docs: fix python release docs package registry by @marandaneto in https://github.com/PostHog/posthog-python/pull/516
• chore: use client-id for create-github-app-token by @marandaneto in https://github.com/PostHog/posthog-python/pull/517
• chore: update GitHub Actions for Node 24 by @marandaneto in https://github.com/PostHog/posthog-python/pull/518
• chore: remove use of six and mock by @s-t-e-v-e-n-k in https://github.com/PostHog/posthog-python/pull/442
• chore: reduce Dependabot PR noise by @marandaneto in https://github.com/PostHog/posthog-python/pull/519
• feat(prompts): add capture_errors option for error tracking by @andrewm4894 in https://github.com/PostHog/posthog-python/pull/520
• docs: add dedicated contributing guides by @marandaneto in https://github.com/PostHog/posthog-python/pull/521
• docs: align contributing guide with CI checks by @marandaneto in https://github.com/PostHog/posthog-python/pull/522
• chore: remove v prefix from release tags by @marandaneto in https://github.com/PostHog/posthog-python/pull/524
• fix: trim whitespace from API keys and host config by @marandaneto in https://github.com/PostHog/posthog-python/pull/525

New Contributors

• @s-t-e-v-e-n-k made their first contribution in https://github.com/PostHog/posthog-python/pull/442

Full Changelog: https://github.com/PostHog/posthog-python/compare/v7.12.0...7.13.0

What's Changed

• chore: merge master into main by @marandaneto in https://github.com/PostHog/posthog-python/pull/513

Full Changelog: https://github.com/PostHog/posthog-python/compare/v7.11.2...v7.12.0

What's Changed

• chore: add GitHub community health files by @marandaneto in https://github.com/PostHog/posthog-python/pull/505
• chore(deps): bump pyasn1 from 0.6.1 to 0.6.3 by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/465
• chore(deps): bump litellm from 1.82.6 to 1.83.0 in /examples/example-ai-dspy by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/487
• chore(deps): bump requests from 2.32.5 to 2.33.0 by @dependabot[bot] in https://github.com/PostHog/posthog-python/pull/473
• chore: update branch references to main by @marandaneto in https://github.com/PostHog/posthog-python/pull/506
• chore: update endpoint for flags local eval by @patricio-posthog in https://github.com/PostHog/posthog-python/pull/509

New Contributors

• @dependabot[bot] made their first contribution in https://github.com/PostHog/posthog-python/pull/465

Full Changelog: https://github.com/PostHog/posthog-python/compare/v7.11.1...v7.11.2