Python product analytics installation

  1. Install the package

    Required

    Install the PostHog Python library using pip:

    Terminal
    pip install posthog

  2. Initialize PostHog

    Required

    Initialize the PostHog client with your project API key and host from your project settings:

    Python
    from posthog import Posthog
    

    posthog = Posthog(
        project_api_key='<ph_project_api_key>',
        host='https://us.i.posthog.com'
    )
    Django integration

    If you're using Django, check out our Django integration for automatic request tracking.

  3. Send events

    Capture custom events by calling the capture method with an event name and properties:

    Python
    import posthog
    

    posthog.capture('user_signed_up', properties={'example_property': 'example_value'})

    By default, for backwards compatibility reasons, events are sent with person profile processing enabled. This means a person profile will be created for each user who triggers an event.

    If you want to disable person profile processing for certain events, send the event with the following property:

    Python
    "$process_person_profile": False

Community questions

Was this page useful?

Questions about this page? or post a community question.