posthog README

The project's README from github.com/PostHog/posthog. As one markdown file: README.md.

posthoglogo

GitHub contributors PRs Welcome Docker Pulls GitHub commit activity GitHub closed issues

Docs - Community - Roadmap - Why PostHog? - Changelog - Bug reports

PostHog Demonstration

PostHog is the open source platform for building self-driving products

PostHog provides every tool you need to build a successful product, and captures all the context agents need to proactively diagnose problems, uncover opportunities, and ship fixes:

You can steer it all from Slack, web, desktop (PostHog Desktop), or your own editor via the MCP.

Best of all, all of this is free to use with a generous monthly free tier for each tool. Get started by signing up for PostHog Cloud US or PostHog Cloud EU.

Table of Contents

Getting started with PostHog

The fastest and most reliable way to get started with PostHog is signing up for free to PostHog Cloud or PostHog Cloud EU. Your first 1 million events, 5k recordings, 1M flag requests, 100k exceptions, and 1500 survey responses are free every month, after which you pay based on usage.

Self-hosting the open-source hobby deploy (Advanced)

If you want to self-host PostHog, you can deploy a hobby instance in one line on Linux with Docker (recommended 4GB memory):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/posthog/posthog/HEAD/bin/deploy-hobby)"

Open source deployments should scale to approximately 100k events per month, after which we recommend migrating to a PostHog Cloud.

We do not provide customer support or offer guarantees for open source deployments. See our self-hosting docs, troubleshooting guide, and disclaimer for more info.

Setting up PostHog

Once you've got a PostHog instance, you can set it up by installing our JavaScript web snippet, one of our SDKs, or by using our API. You can also connect the MCP to bring PostHog into Claude Code, Cursor, or any MCP-compatible agent.

We have SDKs and libraries for popular languages and frameworks like:

Frontend Mobile Backend
JavaScript React Native Python
Next.js Android Node
React iOS PHP
Vue Flutter Ruby

Beyond this, we have docs and guides for Go, .NET/C#, Django, Angular, WordPress, Webflow, and more.

Once you've installed PostHog, see our product docs for more information on how to set up product analytics, web analytics, session replays, feature flags, experiments, error tracking, surveys, data warehouse, and more.

Learning more about PostHog

Our code isn't the only thing that's open source 😳. We also open source our company handbook which details our strategy, ways of working, and processes.

Curious about how to make the most of PostHog? We wrote a guide to winning with PostHog which walks you through the basics of measuring activation, tracking retention, and capturing revenue.

Contributing

We <3 contributions big and small:

For an overview of the codebase structure, see monorepo layout and products.

Open-source vs. paid

This repo is available under the MIT expat license, except for the ee directory (which has its license here) if applicable.

Need absolutely 💯% FOSS? Check out our posthog-foss repository, which is purged of all proprietary code and features.

The pricing for our paid plan is completely transparent and available on our pricing page.

We're hiring!

Hedgehog working on a Mission Control Center

Hey! If you're reading this, you've proven yourself as a dedicated README reader.

You might also make a great addition to our team. We're growing fast and would love for you to join us.

posthog (PostHog/posthog)

Searching Database…

40.3K ·GitHub
Posthog
What is this?PostHog is an open source platform for building 'self-driving products' that bundles product analytics, web analytics, session replay, feature flags, experiments, error tracking, logs, surveys, a data warehouse, and AI observability into one tool.
Is this a single tool or a suite of products?It is a suite of connected developer tools (analytics, replay, flags, experiments, error tracking, logs, surveys, data warehouse) that you steer from one platform, controllable via Slack, web, desktop, or MCP.
How do I get PostHog running?The fastest way is signing up for PostHog Cloud (US or EU); for self-hosting there's a one-line Docker hobby deploy on Linux. After that you set it up with the JavaScript web snippet, one of the SDKs, or the API.
What do I need to connect PostHog to my app?You need a PostHog instance (Cloud or self-hosted) plus either the JS web snippet, an SDK for your language/framework (JS, Next.js, React, Vue, React Native, Android, iOS, Flutter, Python, Node, PHP, Ruby, and more via docs), or the API/MCP.
What's the catch with self-hosting the open-source version?The open-source hobby deploy is only expected to scale to about 100k events/month, and PostHog explicitly provides no customer support or guarantees for self-hosted open-source deployments.
Does PostHog work with mobile apps too, or just web?Both — it has web/JS SDKs plus native SDKs for React Native, Android, iOS, and Flutter, alongside backend SDKs for Python, Node, PHP, and Ruby.
What does 'self-driving mode' actually do?It turns signals in your product data (errors, rage clicks, failed queries, etc.) into researched reports and pull requests that you review and merge.
Can I control PostHog from my coding agent?Yes, you can connect PostHog's MCP to bring it into Claude Code, Cursor, or any MCP-compatible agent/editor.
Is PostHog free to use?Yes, there's a generous monthly free tier for every tool (e.g. first 1 million events, 5k recordings, 1500 survey responses), after which usage-based pricing applies.
What external tools can PostHog pull data from?Its data warehouse feature can sync data from external tools like Stripe and Hubspot, and data pipelines can export to 25+ tools or any webhook.
What are similar projects?openreplay, rybbit, umami, unleash, analytics, formbricks, ToolJet, matomo
Which topics is it in?experiments, feature-flags, session-replay, data-warehouse, web-analytics, cdp, saas, analytics, workflow-automation, observability, dashboard, cloud
Creator
PostHog
Size
7.7 GB
Stars
40.3K
Updated
CommitOct 17Releasedesktop-v0.61.737Oct 16
Age
6y
Commits · 90 Days