https://github.com/PascaleBeier/hitkeep
HitKeep is privacy-first analytics for humans and AI agents, self-hosted or in managed EU/US cloud regions.
https://github.com/PascaleBeier/hitkeep
agent-skills ai analytics angular go mcp
Last synced: about 18 hours ago
JSON representation
HitKeep is privacy-first analytics for humans and AI agents, self-hosted or in managed EU/US cloud regions.
- Host: GitHub
- URL: https://github.com/PascaleBeier/hitkeep
- Owner: PascaleBeier
- License: mit
- Created: 2025-11-08T11:56:11.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-06-24T18:08:50.000Z (5 days ago)
- Last Synced: 2026-06-24T18:18:20.172Z (5 days ago)
- Topics: agent-skills, ai, analytics, angular, go, mcp
- Language: Go
- Homepage: https://hitkeep.com
- Size: 231 MB
- Stars: 61
- Watchers: 0
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-duckdb - HitKeep - Open-source, privacy-first web analytics for traffic, funnels, ecommerce, Search Console, and AI visibility. Runs as a single Go binary with embedded DuckDB. (Tools Powered by DuckDB)
README
# HitKeep
> Privacy-first analytics for humans and AI agents, self-hosted or in EU/US cloud.
[](https://github.com/PascaleBeier/hitkeep/actions/workflows/ci.yml)
[](https://github.com/PascaleBeier/hitkeep/releases)
[](./LICENSE)
[](https://github.com/PascaleBeier/hitkeep/blob/main/go.mod)
[](https://github.com/PascaleBeier/hitkeep/blob/main/frontend/dashboard/package.json)
[](https://hub.docker.com/r/pascalebeier/hitkeep)
[](https://hitkeep.com/guides/introduction/)
[](https://www.bestpractices.dev/projects/11990)
HitKeep is open source web analytics for teams that want useful product reporting without running PostgreSQL, Redis, ClickHouse, or a separate queue.
- Single Go binary with embedded DuckDB and NSQ
- Cookie-less tracker by default, with Do Not Track support
- Traffic, events, goals, funnels, ecommerce, UTM, and email reports
- Google Search Console aggregate import for query, page, country, and device reporting
- AI visibility analytics for crawler fetches and AI-referred visits
- Scoped API clients and a read-only MCP analytics server for approved agents
- Self-hosted or managed cloud with EU/US region choice
[AI Performance](https://hitkeep.com/ai-performance/) · [Website](https://hitkeep.com) · [Cloud](https://hitkeep.com/cloud) · [Live Demo](https://demo.hitkeep.com/share/7a55968bb42df256512fbe7ff73ab88f29dd45c236eddc818bd66420b4ffbaad) · [Docs](https://hitkeep.com/guides/introduction/) · [API](https://hitkeep.com/api/) · [Releases](https://github.com/PascaleBeier/hitkeep/releases)
## Why HitKeep
HitKeep is for teams that need clear web analytics, conversion reporting, and AI-era search visibility in one small operational footprint.
- **Low-ops self-hosting:** one binary, one data directory, embedded DuckDB and NSQ
- **Useful reports:** top pages, landing and exit pages, events, goals, funnels, ecommerce, UTM attribution, and Search Console aggregates
- **Privacy defaults:** focused data collection, cookie-less tracking, and DNT handling
- **AI visibility:** server-side crawler fetch analytics, AI-referred visits, and correlation reports
- **Team controls:** passkeys, TOTP, site/team permissions, share links, audit logs, API clients, and read-only MCP access
- **Deployment choice:** run it yourself or use managed cloud in the EU or US
## Quick Start
### Binary
Download the latest release for your system:
```bash
wget https://github.com/PascaleBeier/hitkeep/releases/latest/download/hitkeep-linux-arm64
chmod +x hitkeep-linux-arm64
export HITKEEP_JWT_SECRET="replace-this-with-a-long-random-string"
./hitkeep-linux-arm64 -public-url="http://localhost:8080"
```
Open `http://localhost:8080` and create your first account.
### Docker
```yaml
services:
hitkeep:
image: pascalebeier/hitkeep:latest
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- hitkeep_data:/var/lib/hitkeep/data
environment:
HITKEEP_JWT_SECRET: replace-this-with-a-long-random-string
command:
- "-public-url=http://localhost:8080"
volumes:
hitkeep_data: {}
```
```bash
docker compose up -d
```
For production setup, reverse proxies, SMTP, systemd, Kubernetes, S3 archiving, and every configuration flag, use the docs instead of this README:
- [Installation guides](https://hitkeep.com/guides/installation/)
- [Configuration reference](https://hitkeep.com/reference/configuration/)
- [Cloud documentation](https://hitkeep.com/cloud)
## Local Development
Contributors can run the full hot-reload development stack with Docker:
```bash
make dev-docker-seed
```
This starts the Go backend, Angular dashboard, Mailpit, and seeded demo data.
Open `http://localhost:4200` and sign in with `demo@example.com` / `demo1234`.
See [CONTRIBUTING.md](./CONTRIBUTING.md) for Docker-only and native workflows.
## Track Your Site
Once your instance is running and a site is created, add:
```html
```
Custom event example:
```html
window.hk = window.hk || {};
window.hk.event?.("signup", { plan: "pro", source: "landing-page" });
```
Tracker options, ecommerce events, custom events, and advanced tracking examples live here:
- [Tracking docs](https://hitkeep.com/guides/tracking/)
- [Custom events](https://hitkeep.com/guides/tracking/custom-events/)
- [Ecommerce analytics](https://hitkeep.com/guides/analytics/ecommerce/)
- [Google Search Console integration](https://hitkeep.com/guides/integrations/google-search-console/)
- [MCP analytics access](https://hitkeep.com/guides/integrations/mcp/)
- [WordPress integration](https://hitkeep.com/guides/integrations/wordpress/)
- [AI visibility analytics](https://hitkeep.com/guides/analytics/ai-visibility/)
- [CloudFront AI crawler tracking](https://hitkeep.com/guides/tracking/cloudfront-ai-crawler-tracking/)
- [AI chatbot analytics](https://hitkeep.com/guides/analytics/ai-chatbot-analytics/)
- [REST API reference](https://hitkeep.com/api/)
- [Compliance overview](https://hitkeep.com/compliance/overview/)
## Product Tour
See five product screenshots
### Dashboard
### Ecommerce
### Search Console
### AI Visibility
### MCP Access
## Documentation
The maintained reference lives on `hitkeep.com`.
- [Getting started](https://hitkeep.com/guides/introduction/)
- [Installation](https://hitkeep.com/guides/installation/)
- [Configuration](https://hitkeep.com/reference/configuration/)
- [REST API reference](https://hitkeep.com/api/)
- [Compliance](https://hitkeep.com/compliance/overview/)
- [Comparison pages](https://hitkeep.com/vs/)
- [Agent Skills](./skills/)
## Cloud
If you want the same product without running it yourself, start here:
- [Start in the EU](https://cloud.hitkeep.eu/signup)
- [Start in the US](https://cloud.hitkeep.com/signup)
- [Cloud overview](https://hitkeep.com/cloud)
## Development
Prerequisites:
- Go 1.26+
- Node.js 24+
- Make
- A working C toolchain for DuckDB builds
Build from source:
```bash
git clone https://github.com/pascalebeier/hitkeep.git
cd hitkeep
make build
./hitkeep
```
For day-to-day development:
```bash
make dev
```
This starts the Go backend with live reload and the Angular dashboard on `http://localhost:4200`.
For a seeded local workspace with demo data:
```bash
make dev-seed
```
Contributor docs and local development guides:
- [Contributing guide](./CONTRIBUTING.md)
- [Dashboard development notes](./frontend/dashboard/README.md)
- [Changelog](./CHANGELOG.md)
## License
Distributed under the MIT License. See [LICENSE](./LICENSE).