posthog-hello-world

Create a minimal working PostHog example.Use when starting a new PostHog integration, testing your setup,or learning basic PostHog API patterns.Trigger with phrases like "posthog hello world", "posthog example","posthog quick start", "simple posthog code".

⭐920stars🔀111forks📁View on GitHub🕐Updated Jan 9, 2026

When & Why to Use This Skill

This Claude skill streamlines the initial integration of PostHog by generating minimal, functional 'Hello World' code examples. It is designed to help developers quickly verify their environment setup, validate API credentials, and understand core PostHog SDK patterns in languages like TypeScript and Python, significantly reducing the time spent on boilerplate configuration.

Use Cases

  • Initial Integration: Rapidly generate the foundational code required to start tracking events in a new project using PostHog.
  • Environment Validation: Test and confirm that API keys and environment variables are correctly configured and that the development environment can successfully communicate with PostHog servers.
  • Educational Reference: Provide a clear, minimal reference for developers learning the basic initialization and syntax patterns of the PostHog API.
nameposthog-hello-world
description|
allowed-toolsRead, Write, Edit
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

PostHog Hello World

Overview

Minimal working example demonstrating core PostHog functionality.

Prerequisites

  • Completed posthog-install-auth setup
  • Valid API credentials configured
  • Development environment ready

Instructions

Step 1: Create Entry File

Create a new file for your hello world example.

Step 2: Import and Initialize Client

import { PostHogClient } from '@posthog/sdk';

const client = new PostHogClient({
  apiKey: process.env.POSTHOG_API_KEY,
});

Step 3: Make Your First API Call

async function main() {
  // Your first API call here
}

main().catch(console.error);

Output

  • Working code file with PostHog client initialization
  • Successful API response confirming connection
  • Console output showing:
Success! Your PostHog connection is working.

Error Handling

Error Cause Solution
Import Error SDK not installed Verify with npm list or pip show
Auth Error Invalid credentials Check environment variable is set
Timeout Network issues Increase timeout or check connectivity
Rate Limit Too many requests Wait and retry with exponential backoff

Examples

TypeScript Example

import { PostHogClient } from '@posthog/sdk';

const client = new PostHogClient({
  apiKey: process.env.POSTHOG_API_KEY,
});

async function main() {
  // Your first API call here
}

main().catch(console.error);

Python Example

from posthog import PostHogClient

client = PostHogClient()

# Your first API call here

Resources

Next Steps

Proceed to posthog-local-dev-loop for development workflow setup.