Python product analytics installation

Install the package

Required

Install the PostHog Python library using pip:

Terminal
pip install posthog

Required

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

Python
from posthog import Posthog

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

Django integration

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

Recommended

Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:

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

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

Recommended

Now that you're capturing events, continue with the resources below to learn what else Product Analytics enables within the PostHog platform.

Resource	Description
Capturing events	Learn how to capture custom events beyond autocapture
Identifying users	Associate events with specific users
Creating insights	Build trends, funnels, and retention charts
Group analytics	Track events at the company or account level