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
这是什么？PostHog 是一个开源平台，用于构建“自驱动产品”。它把产品分析、网页分析、会话回放、功能开关、实验、错误追踪、日志、调查问卷、数据仓库和 AI 可观测性整合在同一个工具里。
这是单一工具，还是一套产品？它是一套相互连接的开发者工具（分析、回放、功能开关、实验、错误追踪、日志、调查问卷、数据仓库），你可以在同一个平台上统一管理，也可以通过 Slack、网页、桌面端或 MCP 进行控制。
我要怎样才能让 PostHog 跑起来？最快的方式是注册 PostHog Cloud（美国或欧盟节点）。如果要自行部署，Linux 上有一条 Docker 命令即可完成的个人用途部署。之后你可以使用 JavaScript 网页代码片段、某个 SDK 或 API 进行设置。
要把 PostHog 接入我的应用，需要准备什么？你需要一个 PostHog 实例（Cloud 或自行部署），再加上 JS 网页代码片段，或者你所用语言或框架对应的 SDK（JS、Next.js、React、Vue、React Native、Android、iOS、Flutter、Python、Node、PHP、Ruby 等，更多见文档），也可以使用 API 或 MCP。
自行部署开源版本有什么不足之处？开源的个人用途部署预计只能支撑约每月 10 万个事件的规模。另外，PostHog 明确表示，对于自行部署的开源版本不提供客户支持，也不作任何保证。
PostHog 也能用于移动应用吗，还是只支持网页？两者都支持。它既有网页和 JS SDK，也有适用于 React Native、Android、iOS 和 Flutter 的原生 SDK，还有适用于 Python、Node、PHP 和 Ruby 的后端 SDK。
“自驱动模式”到底是做什么的？它会把产品数据中的信号（如错误、愤怒点击、失败的查询等）转化为经过调研的报告和拉取请求，供你审阅后合并。
我能在编程智能体里控制 PostHog 吗？可以。你可以连接 PostHog 的 MCP，把它接入 Claude Code、Cursor，或任何支持 MCP 的智能体或编辑器。
PostHog 免费吗？免费使用。每个工具都有较为慷慨的月度免费额度（例如前 100 万个事件、5000 条录屏、1500 份调查问卷回复），超出后按用量计费。
PostHog 可以从哪些外部工具拉取数据？它的数据仓库功能可以从 Stripe、Hubspot 等外部工具同步数据，数据管道则可以导出到 25 个以上的工具，或任意 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 18Releasedesktop-v0.61.746Oct 18
Age
6y
Commits · 90 Days