junglans-trail

Embedded local-first analytics & on-page heatmap middleware for Python (FastAPI & Starlette).
Developed by Junglans • junglans.in

104 Capabilities. Zero standalone servers. Store all analytics and user telemetry directly in your application's local SQLite database under /api/jungtrail.

Installation

With uv (Recommended)

uv add junglans-trail

With pip

pip install junglans-trail

30-Second Quickstart (FastAPI)

Mount the analytics router onto your existing FastAPI app in 3 lines:

from fastapi import FastAPI
from junglans_trail import jungtrail_fastapi_middleware

app = FastAPI()

# Mounts all 104 analytics, heatmap, auth, and e-commerce endpoints under /api/jungtrail
storage = jungtrail_fastapi_middleware(
    app,
    db_name="analytics.db",       # Custom SQLite WAL database name
    db_path="data/analytics.db",  # Custom database storage path
    admin_key="your-admin-secret" # Protects stats, export, and heatmap endpoints
)

@app.get("/")
def home():
    return {"message": "Hello from Junglans Trail"}

Backend Event Tracking in Python

Track backend business, auth, and e-commerce events directly from Python:

from junglans_trail import TrailClient

client = TrailClient(
    endpoint="http://localhost:8000/api/jungtrail",
    write_key="optional-key"
)

# E-Commerce transaction
client.track(
    event_type="purchase",
    route="/checkout/success",
    meta={"order_id": "ord_9901", "revenue": 149.00, "items_count": 2}
)

# Auth & session telemetry
client.track(
    event_type="login_success",
    route="/api/v1/auth/login",
    meta={"provider": "github", "user_id": "usr_abc"}
)

client.flush()

REST Endpoints Overview

Developer & Organization

• Organization: Junglans
• Website: https://junglans.in
• Email: contact@junglans.in
• License: MIT