PascaleBeier/hitkeep

View on GitHub ↗

100% open-source, AI-native web analytics with cookieless tracking, open exports, custom domains, and SSO—self-hosted as one Go binary or managed in EU/US cloud.

82 ★7 forksGoUpdated 18d ago

What you need to know

AI-native, sovereign, privacy-first web analytics shipped as one self-hosted Go binary (embedded DuckDB + NSQ) that unifies traffic, conversions, Search Console, and AI visibility, with an Ask AI feature and read-only MCP for approved assistants.

Install

curl -fsSLo compose.yml https://raw.githubusercontent.com/PascaleBeier/hitkeep/main/examples/compose.yml && curl -fsSLo .env https://raw.githubusercontent.com/PascaleBeier/hitkeep/main/examples/.env.example && docker compose up -d

Usage

  • Fill .env with a long random value (replace paste-the-generated-value-here), run docker compose up -d, then open http://localhost:8080 and create the first account.
  • Add the tracker to your pages: <script async src="https://analytics.example.com/hk.js"></script>.
  • Use custom events for product-specific actions such as signups, purchases, or qualified leads.
  • Before exposing an instance publicly, follow the Docker Compose guide for HTTPS and trusted proxies, and review backups and the configuration reference.

Key features

  • 100% open source (MIT) with custom tracking domains and team SSO in the same public codebase.
  • AI-native analytics: crawler fetches, AI-referred visits, and chatbot outcomes stay distinct; Ask AI answers with cited aggregate evidence; read-only MCP gives approved assistants governed analytics access.
  • Privacy by default: the browser tracker sets no analytics cookies, respects Do Not Track, and doesn't build a cross-site identity.
  • Reporting across pages, automatic and custom events, goals, funnels, ecommerce revenue, UTM/QR campaigns, Search Console, and Web Vitals.
  • Full data sovereignty: self-host one binary or export via takeout, REST APIs, webhooks, and share links.

Best for

Self-hosters who want cookie-free, open-source web analytics with AI visibility and governed assistant/MCP access.

Caveats

  • Web-focused by design: favors aggregate traffic and conversion evidence over visitor profiles, session replay, mobile SDKs, or built-in experimentation.
  • Keep .env private and retain the same secret across restarts; follow the HTTPS/proxy guide before public exposure.
  • The README doesn't document the MCP transport; MCP access is described as read-only.
Platforms: Web · Local

Reviewed 2026-08-18

Topics

ai-analyticsai-nativeai-visibilityanalyticsanalytics-dashboardconversion-analyticscookielesscustom-domainsdata-sovereigntyduckdbecommerce-analyticsgogoogle-analytics-alternativemodel-context-protocolopen-source-analyticsprivacy-friendlyself-hostedsingle-sign-onweb-analyticswebsite-analytics
Stars
82★
Forks
7
Language
Go
License
MIT
Created
2025-11-08
Last push
2026-08-18