Overview:
Wakapi is a minimalist, self-hosted backend for coding statistics that is compatible with WakaTime. It tracks time spent on projects, languages, editors, hosts, and operating systems by receiving data from WakaTime client plugins. Developers can use it to collect and view personal coding activity without relying on third-party cloud services. It supports SQLite, MySQL, MariaDB, and Postgres databases, and can be deployed via binary release, Docker, or compiled from source.
Core Features:
Project and language statistics: Tracks and displays coding activity broken down by projects, programming languages, editors, operating systems, and host machines.
Weekly email reports: Automatically sends a summary of weekly coding statistics to users via email on a configurable schedule.
REST API: Exposes a programmatic interface compatible with WakaTime's authentication model and endpoint structure.
WakaTime integration: Supports parallel use with WakaTime by forwarding heartbeats to WakaTime or importing historic data from the service.
Prometheus export: Exposes coding statistics for scraping by Prometheus, enabling visualization in tools like Grafana.
Badges and public leaderboard: Can generate embeddable status badges and optionally maintain a configurable public leaderboard (daily, weekly, monthly, or yearly aggregates).
Use Cases:
Developers who want to self-host their coding activity tracking instead of using a third-party cloud service like WakaTime.
Users who want to generate and display embeddable coding stats badges on GitHub profiles or other websites.
Teams or individual developers who need a Prometheus-compatible metrics endpoint to feed coding statistics into a Grafana dashboard.
Self-hosters who require a lightweight, single-binary backend deployable via Docker or on Kubernetes using the provided Helm chart.
Why It Matters:
Wakapi provides an openly auditable, self-hosted alternative to the WakaTime cloud service for coding activity tracking. It reuses the existing WakaTime client ecosystem, so users can keep their existing editor plugins. The project explicitly does not include team features, leaderboards with user comparisons, or embedded charts—it focuses solely on individual stat collection and visibility. Its REST API and Prometheus export support let users integrate data into their own observability pipelines.
