posthog-install-auth

Install and configure PostHog SDK/CLI authentication.Use when setting up a new PostHog integration, configuring API keys,or initializing PostHog in your project.Trigger with phrases like "install posthog", "setup posthog","posthog auth", "configure posthog API key".

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

When & Why to Use This Skill

This Claude skill automates the installation and configuration of the PostHog SDK and CLI for both Node.js and Python environments. It streamlines the developer onboarding process by handling package management (npm/pip), secure API key authentication, and environment variable setup, ensuring a fast and error-free integration of product analytics into any codebase.

Use Cases

  • Quickly initializing PostHog in a new web application to start tracking user behavior and events.
  • Configuring server-side analytics by installing the PostHog Python SDK and setting up necessary environment variables.
  • Automating the creation of .env files and API key configurations to maintain security best practices during development.
  • Troubleshooting initial connection issues by verifying SDK installation and authentication credentials against PostHog's API.
nameposthog-install-auth
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

PostHog Install & Auth

Overview

Set up PostHog SDK/CLI and configure authentication credentials.

Prerequisites

  • Node.js 18+ or Python 3.10+
  • Package manager (npm, pnpm, or pip)
  • PostHog account with API access
  • API key from PostHog dashboard

Instructions

Step 1: Install SDK

# Node.js
npm install @posthog/sdk

# Python
pip install posthog

Step 2: Configure Authentication

# Set environment variable
export POSTHOG_API_KEY="your-api-key"

# Or create .env file
echo 'POSTHOG_API_KEY=your-api-key' >> .env

Step 3: Verify Connection

// Test connection code here

Output

  • Installed SDK package in node_modules or site-packages
  • Environment variable or .env file with API key
  • Successful connection verification output

Error Handling

Error Cause Solution
Invalid API Key Incorrect or expired key Verify key in PostHog dashboard
Rate Limited Exceeded quota Check quota at https://docs.posthog.com
Network Error Firewall blocking Ensure outbound HTTPS allowed
Module Not Found Installation failed Run npm install or pip install again

Examples

TypeScript Setup

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

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

Python Setup

from posthog import PostHogClient

client = PostHogClient(
    api_key=os.environ.get('POSTHOG_API_KEY')
)

Resources

Next Steps

After successful auth, proceed to posthog-hello-world for your first API call.