GeoPulse is a self-hosted platform transforming raw GPS data from tracking apps into organized timelines and insights. It automatically categorizes location data into stays and trips, providing users a clear view of movement patterns while ensuring complete data ownership. Designed for privacy-conscious users, it offers benefits like seamless Immich integration for photo visualization on the timeline map.

How It Works

The platform features a Java backend on Quarkus (native mode) and a PostGIS database for geospatial data. Its frontend uses Vue.js 3 with Leaflet for interactive maps. GeoPulse ingests data from sources like OwnTracks, processing it for stay/trip detection. Key innovations include AI-powered location insights and a chat assistant for natural language queries about travel habits, plus Immich integration for enriched timeline context.

Quick Start & Requirements

Deployment is available via Docker Compose (local/production) or Kubernetes (Helm charts). Prerequisites include Docker and Docker Compose. An optional MQTT broker is supported for OwnTracks integration, and an OpenAI-compatible service with user-provided API keys is required for the AI chat assistant. Comprehensive deployment and configuration guides are available.

Highlighted Details

• Broad Integration: Supports OwnTracks (HTTP/MQTT), Overland, Dawarich, HomeAssistant, GPSLogger, and manual imports (Google Timeline, GPX, GeoJSON).
• Immich Synergy: Displays photos from Immich directly on the timeline map.
• AI-Powered Insights: Features an AI Chat Assistant for natural language queries on travel habits and patterns, compatible with OpenAI-compatible services.
• Privacy & Sharing: Offers granular controls, friend connections, real-time sharing, public links, and time-limited/password-protected access.
• Customization: Supports custom map tiles, adjustable timeline sensitivity, multiple reverse geocoding APIs, and data export.
• Authentication: Includes traditional username/password and OIDC/SSO compatibility.

Maintenance & Community

The README does not specify community channels, notable contributors, or sponsorship details.

Licensing & Compatibility

Licensed under the Business Source License 1.1 (BSL 1.1), GeoPulse is free for personal, educational, and non-commercial use. Commercial use requires a separate license; contact kerriden1@gmail.com for inquiries.

Limitations & Caveats

Commercial deployment is restricted by the BSL 1.1 license. The AI Chat Assistant requires users to supply their own API keys for the underlying service.