GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - HitKeep/hitkeep: 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.

BranchesTags
Open more actions menu

Latest commit

 

History

890 Commits
890 Commits

Folders and files

NameName
Last commit message
Last commit date
.agents/skills
.agents/skills
 
 
.github
.github
 
 
ai
ai
 
 
aianalytics
aianalytics
 
 
analyticstools
analyticstools
 
 
api
api
 
 
appurl
appurl
 
 
assetstore
assetstore
 
 
auth
auth
 
 
blocking
blocking
 
 
charts/hitkeep
charts/hitkeep
 
 
cluster
cluster
 
 
cmd
cmd
 
 
config
config
 
 
database
database
 
 
devtool
devtool
 
 
docs
docs
 
 
duckdbextensions
duckdbextensions
 
 
entitlements
entitlements
 
 
examples
examples
 
 
exportfmt
exportfmt
 
 
frontend
frontend
 
 
hklog
hklog
 
 
importables
importables
 
 
ingest
ingest
 
 
ipmeta
ipmeta
 
 
jsonapi
jsonapi
 
 
listrefresh
listrefresh
 
 
localization
localization
 
 
mailables
mailables
 
 
mailer
mailer
 
 
mailpreview
mailpreview
 
 
mcpserver
mcpserver
 
 
mcptest
mcptest
 
 
oauth
oauth
 
 
opportunities
opportunities
 
 
public
public
 
 
realtime
realtime
 
 
reporting
reporting
 
 
scripts
scripts
 
 
searchconsole
searchconsole
 
 
security
security
 
 
server
server
 
 
skills
skills
 
 
socialauth
socialauth
 
 
sso
sso
 
 
takeout
takeout
 
 
tests
tests
 
 
testutil
testutil
 
 
webhookdispatcher
webhookdispatcher
 
 
webhooks
webhooks
 
 
worker
worker
 
 
.air.toml
.air.toml
 
 
.dockerignore
.dockerignore
 
 
.gitignore
.gitignore
 
 
.golangci.yml
.golangci.yml
 
 
.goreleaser.yaml
.goreleaser.yaml
 
 
.release-please-manifest.json
.release-please-manifest.json
 
 
AGENTS.md
AGENTS.md
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CLAUDE.md
CLAUDE.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
DESIGN.md
DESIGN.md
 
 
Dockerfile
Dockerfile
 
 
LICENSE
LICENSE
 
 
NOTICE
NOTICE
 
 
PRODUCT.md
PRODUCT.md
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
compose.cluster.yaml
compose.cluster.yaml
 
 
compose.dev.yaml
compose.dev.yaml
 
 
compose.yaml
compose.yaml
 
 
glama.json
glama.json
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 
hitkeep.example.yaml
hitkeep.example.yaml
 
 
hk
hk
 
 
release-please-config.json
release-please-config.json
 
 
server.json
server.json
 
 
skills-lock.json
skills-lock.json
 
 

Repository files navigation

HitKeep

AI native, sovereign, privacy-first web analytics in one binary.

100% open source under MIT, HitKeep unifies traffic, conversions, Search Console, and AI visibility with custom tracking domains, SSO, open exports, and no separate database, queue, or cache.

Self-host · Documentation · Cloud · Website

Latest release Continuous integration status MIT license Docker pulls OpenSSF Best Practices badge

HitKeep dashboard showing traffic metrics, a 30-day comparison chart, and analytics navigation

Why HitKeep

  • 100% open source. The complete product is MIT-licensed. Custom tracking domains and team SSO live in the same public codebase—not in a separate proprietary edition.
  • Full data sovereignty. Self-host one Go binary with embedded DuckDB and NSQ, or export your data in open formats. Complete takeout, APIs, webhooks, share links, and permissions keep the data useful outside HitKeep.
  • AI-native analytics. HitKeep treats AI as a first-class traffic channel: crawler fetches, AI-referred visits, and chatbot outcomes remain distinct. Ask AI uses cited aggregate evidence, while read-only MCP gives approved assistants governed analytics access.
  • Privacy by default. The browser tracker sets no analytics cookies, respects Do Not Track, and collects focused website analytics without building a cross-site identity.
  • Reporting that reaches the outcome. Follow acquisition through pages, automatic and custom events, goals, funnels, ecommerce revenue, UTM and QR campaigns, Search Console, and Web Vitals.

Self-host the complete open-source product, or use HitKeep Cloud in a managed EU or US region when you do not want to operate it yourself.

HitKeep is web-focused. It favors aggregate traffic and conversion evidence over visitor profiles, session replay, mobile SDKs, or built-in experimentation. The result is a smaller collection boundary and operating surface without stopping at a basic pageview counter.

Quick Start

On Apple silicon macOS or x86_64 Linux, install HitKeep with Homebrew:

brew install HitKeep/hitkeep/hitkeep
hitkeep --version

Follow the Homebrew installation guide to configure and start HitKeep. On Linux ARM64, use the published ARM64 binary or Docker instead.

For a production-oriented self-hosted setup, download the Docker Compose file and environment template:

mkdir hitkeep && cd hitkeep
curl -fsSLo compose.yml https://raw.githubusercontent.com/HitKeep/hitkeep/main/examples/compose.yml
curl -fsSLo .env https://raw.githubusercontent.com/HitKeep/hitkeep/main/examples/.env.example

Open .env and replace paste-the-generated-value-here with a long random value from your password manager. Then start HitKeep:

docker compose up -d

Open http://localhost:8080 and create the first account. Keep .env private and retain the same secret across restarts.

Before exposing an instance publicly, follow the Docker Compose guide for HTTPS and trusted proxies, then review backups and the configuration reference. For a native Linux service, download an AMD64 or ARM64 binary from GitHub Releases and follow the binary installation guide.

Track Your First Site

Create a site in the dashboard, then add the tracker to your pages:

<script async src="https://analytics.example.com/hk.js"></script>

Pageviews and supported automatic interaction events—outbound clicks, file downloads, and form submissions—start flowing immediately. Use the custom events guide for product-specific actions such as signups, purchases, or qualified leads.

Explore HitKeep

See AI visibility, ecommerce, Search Console, Ask AI, and Assistants

AI visibility

HitKeep AI visibility report separating crawler fetches, AI referrals, and related activity

Ecommerce

HitKeep ecommerce analytics showing revenue KPIs, trends, top products, and revenue sources

Search Console

HitKeep Search Console report showing clicks, impressions, click-through rate, position, and query trends

Ask AI

HitKeep Ask AI answer with completed analytics tools, cited evidence, a table, and a safe dashboard action

Assistants

HitKeep Assistants setup showing the MCP endpoint, connection guides, and OAuth access controls

Documentation, Community, and Support

Find answers in the documentation, report reproducible bugs through GitHub Issues, and disclose vulnerabilities privately through the security policy.

Contributor quick path

Run ./hk setup, then start seeded development with ./hk dev --seed or use ./hk dev --detach. Capture product proof with ./hk screenshot; inspect ./hk catalog commands --output json and ./hk catalog configuration --output json instead of copying mutable workflow facts. Validate with ./hk qa pr. The Compose stack and complete workflow live in CONTRIBUTING.md.

  • Operate: Installation · Configuration · REST API · Goals · Funnels
  • Evaluate: Comparison library · Compliance · Releases · Changelog
  • Contribute: Contributor guide · Security policy · Issues
  • Support open source: Fund HitKeep on GitHub Sponsors or make a one-time contribution.

License

HitKeep is distributed under the MIT License.

DuckDB extensions

HitKeep includes the DuckDB extensions required for S3 backups and XLSX exports. It does not download extensions at startup. On first use, bundled files are extracted into HITKEEP_DATA_PATH/.duckdb/extensions; this directory must be writable by the process running HitKeep and reside on a mount without noexec. The cache is disposable and can be recreated without network access. No HOME override or separate extension installation is needed for binary, Homebrew, or container deployments.

Contributor instructions for DuckDB upgrades are in the extension bundle documentation.

About

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.

hitkeep.com

Topics

ai-analyticsai-nativeai-visibilityanalyticsanalytics-dashboardconversion-analyticscookielesscustom-domainsdata-sovereigntyduckdbecommerce-analyticsgogoogle-analytics-alternativemodel-context-protocolopen-source-analyticsprivacy-friendlyself-hostedsingle-sign-onweb-analyticswebsite-analytics

Resources

Readme
MIT license

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

106 stars

Watchers

0 watching

Forks

11 forks
Report repository

Releases

Sponsor this project

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.