Skip to content

quickstart.mdx

Latest commit

 

History

History
114 lines (79 loc) · 2.48 KB

quickstart.mdx

File metadata and controls

114 lines (79 loc) · 2.48 KB
title description
Quickstart
Get started with Timepoint AI — render your first historical moment in minutes.

Quickstart

Flash — Render a Historical Moment

Flash is the fastest way to see Timepoint in action. It generates grounded historical scenes from natural language.

Prerequisites

Install and Run

git clone https://github.com/timepointai/timepoint-flash.git
cd timepoint-flash
pip install -e .

Set your API key:

export GOOGLE_API_KEY="your-key-here"

Start the server:

flash serve

Render a Moment

curl -X POST http://localhost:8000/api/v1/timepoints/generate/sync \
  -H "Content-Type: application/json" \
  -d '{"query": "AlphaGo plays Move 37, Seoul, March 10 2016", "generate_image": true}'

You'll get back a complete scene: characters with distinct voices, period-accurate dialog, relationship dynamics, source citations, and a photorealistic image.

Pro — Run a Social Simulation

Pro is the SNAG engine — it simulates social dynamics with causal provenance.

Install and Run

git clone https://github.com/timepointai/timepoint-pro.git
cd timepoint-pro
pip install -e .

Set your LLM provider:

export OPENROUTER_API_KEY="your-key-here"

Run a Simulation

python run.sh --template board-meeting --fidelity 3

Pro supports 21 verified templates at $0.15–$1.00 per run.

Clockchain — Query the Graph

The Clockchain is a public API — no authentication needed for read access.

Browse Moments

# Get graph statistics
curl https://clockchain.timepointai.com/api/v1/stats

# List moments
curl "https://clockchain.timepointai.com/api/v1/moments?limit=10"

# Search by keyword
curl "https://clockchain.timepointai.com/api/v1/moments?q=rome"

# Filter by date range
curl "https://clockchain.timepointai.com/api/v1/moments?year_from=1900&year_to=2000"

Next Steps

Understand timepoints, SNAG, and temporal modes The 14-agent pipeline explained Full endpoint documentation How the temporal graph works