Skip to content

analytics_routes

analytics_routes

Small router exposing the anonymous analytics identity to the frontend.

The Tauri desktop app and web frontend need the same anon_id that the backend and install.sh use so that all events tie to one person. This endpoint returns that ID (generating it on first call) plus the public PostHog project key and host so the frontend can initialise posthog-js against the same project.

Public API — no auth required because the data returned is exactly what the frontend would ship to PostHog anyway. The project key is a public token, not a secret.

Functions

get_identity 

get_identity() -> AnalyticsIdentity

Return the analytics identity for the current install.

If analytics is disabled in config, still return a structurally valid response with enabled=False so the frontend can decide what to do; never throw.

Source code in src/openjarvis/server/analytics_routes.py 
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
@router.get("/identity", response_model=AnalyticsIdentity)
def get_identity() -> AnalyticsIdentity:
    """Return the analytics identity for the current install.

    If analytics is disabled in config, still return a
    structurally valid response with ``enabled=False`` so the frontend
    can decide what to do; never throw.
    """
    cfg = load_config()
    enabled = is_analytics_enabled(cfg.analytics)
    anon_id = get_or_create_anon_id(cfg.analytics.anon_id_path) if enabled else ""
    return AnalyticsIdentity(
        enabled=enabled,
        anon_id=anon_id,
        host=cfg.analytics.host,
        key=cfg.analytics.key if enabled else "",
    )