Skip to main content

​
Timepoint AI

Timepoint is the infrastructure layer for temporal reasoning. We render the past to understand it. We render the future to choose it.

​
What is Timepoint?

Timepoint is an open-source ecosystem of integrated services that work together to build a persistent, growing model of historical and future causality:

Gateway

The Front Door — API gateway at api.timepointai.com. Handles authentication (Apple, Google, GitHub OAuth), JWT signing, credits, and user management. All client traffic enters here.

Flash

The Reality Writer — type any moment in history, get a grounded scene with characters, dialog, and a photorealistic image via a 14-agent critique-loop pipeline.

Pro

The SNAG Engine — social simulation with 19 composable mechanisms, 5 temporal modes, causal provenance, and structured social graphs.

Clockchain

The Temporal Causal Graph — 1,900+ nodes, 5M+ edges, 700 BCE to 2026. PostgreSQL-backed directed graph that accumulates rendered past and simulated future into a growing Bayesian prior.

Billing

The Commerce Layer — Stripe payments, Apple IAP, and invite codes. Coordinates with Gateway to grant credits.

TDF

The Data Format — JSON-LD interchange format with content-addressed SHA-256 hashing. The universal data contract.

SNAG-Bench

The Quality Certifier — temporal reasoning benchmark with 60 adversarial tasks, 5 scoring axes, designed to stay hard through 2030.

Proteus

The Settlement Layer — prediction market protocol on BASE L2 where rendered futures are scored against reality.

​
Core Concept: SNAG

Social Network Augmented Generation synthesizes and maintains structured social graphs — with causal provenance, knowledge flow, emotional states, and temporal consistency — to ground LLM generation in complex group dynamics. Where RAG answers questions from what was written down, SNAG reasons about what people did, felt, and caused.
AspectRAGSNAG
InputDocument corpusScenario + entities + relationships
StructureFlat chunksDirected causal graph
TemporalSnapshotMulti-mode (forward, branching, cyclical)
OutputAnswer + citationsSimulation state + dialog + provenance

​
Architecture

All client traffic enters through the API Gateway (api.timepointai.com), which handles authentication, credits, and user management. The Gateway proxies generation requests to Flash with an X-User-ID header. Flash produces grounded scenes, drawing on Clockchain (causal graph), Pro (SNAG engine), and SNAG-Bench (benchmark). Billing handles payments and coordinates with Gateway to grant credits. Clockchain and Pro share TDF (data format) as their interchange layer. 
                     api.timepointai.com
                              │
                    ┌─────────▼──────────┐
                    │  Gateway (Auth,     │
                    │  Credits, Users)    │
                    └─────────┬──────────┘
                              │ X-User-ID
                    ┌─────────▼──────────┐    ┌─────────────────┐
                    │   Flash (Renderer)  │    │    Billing       │
                    │  (no auth — pure    │    │  (Stripe, IAP,   │
                    │   generation engine)│    │   invite codes)  │
                    └─────────▲──────────┘    └────────┬────────┘
                              │                        │
              ┌───────────────┼───────────────┐        │
              │               │               │   credits/grant
     ┌────────┴────────┐ ┌───┴────┐ ┌────────┴────────┐
     │   Clockchain    │ │  Pro   │ │   SNAG-Bench    │
     │  (Causal Graph) │ │ (SNAG) │ │  (Benchmark)    │
     └────────┬────────┘ └───┬────┘ └─────────────────┘
              │               │
              └───────┬───────┘
                      │
              ┌───────▼───────┐
              │      TDF      │
              │ (Data Format) │
              └───────────────┘

​
Get Started

New to Timepoint? These four pages cover the shortest path from zero to a working integration:

Quickstart

Clone, install, and render your first moment — one click from here to a working curl command.

Authentication — Key Types

The four credential types (Bearer JWT, API Key, X-Service-Key, X-Admin-Key) and when to use each.

MCP Tools

The six MCP tools (clockchain_stats, clockchain_search, clockchain_moment, clockchain_neighbors, flash_render, pro_simulate).

Errors & Troubleshooting

HTTP status codes, rate-limit headers, and a decision tree for common failures.

​
Go Deeper

Core Concepts

Timepoints, temporal modes, and the Clockchain

API Reference

Gateway, Flash, Clockchain, and Pro API endpoints

GitHub

All source code — Apache-2.0 licensed

Accessibility

WCAG 2.1 Level A conformance statement