Tellodb
Sign up

Section

Fundamentals

OverviewQuickstartInstallCore Concepts
Analytics

The Metric Vault

Track and aggregate numeric truth with absolute deterministic precision.

Deterministic Metric Extraction

Beyond semantic recall, Tellodb uses deterministic regex extractors to identify numeric values during ingestion. These are stored in the Metric Vault—a specialized B-Tree index optimized for temporal range scans.

  • Currency ($50, 100 EUR): Track user spending habits.
  • Distance (5 miles, 10km): Track physical activity and movement.
  • Counts (3 times, 5 people): Track frequency and social context.

Querying the Vault

The `/analytics/query` endpoint allows you to compute sums and counts over specific time windows without hallucination risks.

Aggregation Request
{
  "entity_id": "user-123",
  "label": "money",
  "start_timestamp_ms": 1743465600000,
  "end_timestamp_ms": 1744070400000
}