posthog

• feat: Add $context_tags to an event to know which properties were included as tags

• fix: Always pass project API key in remote_config requests for deterministic project routing

• feat: support Vertex AI for Gemini

• fix: set $ai_tools for all providers and $ai_output_choices for all non-streaming provider flows properly

• fix: get_feature_flag_result now correctly returns FeatureFlagResult when payload is empty string instead of None

• fix: Anthropic's tool calls are now handled properly

• feat: Enhanced send_feature_flags parameter to accept SendFeatureFlagsOptions object for declarative control over local/remote evaluation and custom properties

• feat: make posthog_client an optional argument in PostHog AI providers wrappers (posthog.ai.*), intuitively using the default client as the default

• fix: correctly capture exceptions processed by Django from views or middleware

• feat: decouple feature flag local evaluation from personal API keys; support decrypting remote config payloads without relying on the feature flags poller

• fix: add POSTHOG_MW_CLIENT setting to django middleware, to support custom clients for exception capture.

• feat: add a feature flag evaluation cache (local storage or redis) to support returning flag evaluations when the service is down

• fix: send_feature_flags changed to default to false in Client::capture_exception

• fix: response $process_person_profile property when passed to capture

This release contains a number of major breaking changes:

• feat: make distinct_id an optional parameter in posthog.capture and related functions
• feat: make capture and related functions return Optional[str], which is the UUID of the sent event, if it was sent
• fix: remove identify (prefer posthog.set()), and page and screen (prefer posthog.capture())
• fix: delete exception-capture specific integrations module. Prefer the general-purpose django middleware as a replacement for the django Integration.

To migrate to this version, you'll mostly just need to switch to using named keyword arguments, rather than positional ones. For example:

# Old calling convention
posthog.capture("user123", "button_clicked", {"button_id": "123"})
# New calling convention
posthog.capture(distinct_id="user123", event="button_clicked", properties={"button_id": "123"})

# Better pattern
with posthog.new_context():
    posthog.identify_context("user123")

    # The event name is the first argument, and can be passed positionally, or as a keyword argument in a later position
    posthog.capture("button_pressed")

Generally, arguments are now appropriately typed, and docstrings have been updated. If something is unclear, please open an issue, or submit a PR!

• feat: add support to session_id context on page method

• fix: safely handle exception values

• feat: construct artificial stack traces if no traceback is available on a captured exception

• feat: session and distinct ID's can now be associated with contexts, and are used as such
• feat: django http request middleware

• fix: removed deprecated sentry integration

• fix: no longer fail in autocapture.

• feat(ai): track reasoning and cache tokens in the LangChain callback

• fix: export scoped, rather than tracked, decorator
• feat: allow use of contexts without error tracking

• feat: add support for parse endpoint in responses API (no longer beta)

• fix: replace import posthog with direct method imports

• fix: replace import posthog in posthoganalytics package

• feat: add additional user and request context to captured exceptions via the Django integration
• feat: Add setup() function to initialise default client

• feat: add before_send callback (#249)

• empty point release to fix release automation

• empty point release to fix release automation

• Use the new /flags endpoint for all feature flag evaluations (don't fall back to /decide at all)

1. Add context management:

• New context manager with posthog.new_context()
• Tag functions: posthog.tag(), posthog.get_tags(), posthog.clear_tags()
• Function decorator:
  • @posthog.scoped - Creates context and captures exceptions thrown within the function
• Automatic deduplication of exceptions to ensure each exception is only captured once

1. fix: feature flag request use geoip_disable (#235)
2. chore: pin actions versions (#210)
3. fix: opinionated setup and clean fn fix (#240)
4. fix: release action failed (#241)

Add support for google gemini

Moved ai openai package to a composition approach over inheritance.

1. Remove deprecated monotonic library. Use Python's core time.monotonic function instead
2. Clarify Python 3.9+ is required

1. Added new method get_feature_flag_result which returns a FeatureFlagResult object. This object breaks down the result of a feature flag into its enabled state, variant, and payload. The benefit of this method is it allows you to retrieve the result of a feature flag and its payload in a single API call. You can call get_value on the result to get the value of the feature flag, which is the same value returned by get_feature_flag (aka the string variant if the flag is a multivariate flag or the boolean value if the flag is a boolean flag).

Example:

result = posthog.get_feature_flag_result("my-flag", "distinct_id")
print(result.enabled)     # True or False
print(result.variant)     # 'the-variant-value' or None
print(result.payload)     # {'foo': 'bar'}
print(result.get_value()) # 'the-variant-value' or True or False
print(result.reason)      # 'matched condition set 2' (Not available for local evaluation)

Breaking change:

1. get_feature_flag_payload now deserializes payloads from JSON strings to Any. Previously, it returned the payload as a JSON encoded string.

Before:

payload = get_feature_flag_payload('key', 'distinct_id') # "{\"some\": \"payload\"}"

After:

payload = get_feature_flag_payload('key', 'distinct_id') # {"some": "payload"}

1. Roll out new /flags endpoint to 100% of /decide traffic, excluding the top 10 customers.

1. Fix hash inclusion/exclusion for flag rollout

1. Roll out new /flags endpoint to 10% of /decide traffic

1. Add log_captured_exceptions option to proxy setup

1. Add config option to log_captured_exceptions

1. Expand automatic retries to include read errors (e.g. RemoteDisconnected)

1. Add more information to $feature_flag_called events.
2. Support for the /decide?v=4 endpoint which contains more information about feature flags.

1. Support serializing dataclasses.

1. Add support for OpenAI Responses API.

1. Fix bug where None is sent as delta in azure

1. Add support for tool calls in OpenAI and Anthropic.
2. Add support for cached tokens.

1. Improve quota-limited feature flag logs

1. Add support for Azure OpenAI.

1. The LangChain handler now captures tools in $ai_generation events, in property $ai_tools. This allows for displaying tools provided to the LLM call in PostHog UI. Note that support for $ai_tools in OpenAI and Anthropic SDKs is coming soon.

1. feat: add some platform info to events (#198)

1. Fix async client support for OpenAI.

1. Support quota-limited feature flags

1. Evaluate feature flag payloads with case sensitivity correctly. Fixes https://github.com/PostHog/posthog-python/issues/178

1. Add support for Bedrock Anthropic Usage

1. Automatically retry connection errors