Skip to content

Get Started

Zero to a verified answer

This section takes you from nothing to a running Telha instance that ingests data, answers temporal queries, and generates verified, cited answers.

  • Installation

    Get a telha binary: the Windows dev/eval zip, Docker, or a source build. Prerequisites and platform notes.

    Install Telha

  • Quickstart

    Ten minutes, curl only: API key, serve, ingest, query, time-travel, /v1/generate, and read the trace.

    Run the quickstart

The 10-minute path at a glance

flowchart LR
    A["Get a binary"] --> B["Create an API key<br/>(tenant + org scoped)"]
    B --> C["telha serve"]
    C --> D["Ingest JSON<br/>POST /v1/ingest"]
    D --> E["Query<br/>POST /v1/query"]
    E --> F["Time-travel<br/>/v1/snapshot · /v1/compare"]
    F --> G["Generate<br/>POST /v1/generate"]
    G --> H["Read the trace<br/>GET /v1/trace/:id"]

Every /v1 request needs the x-api-key header. Probes GET /healthz and GET /readyz are unauthenticated. Every error is the uniform envelope {"code", "message", "request_id"}, and every response carries an x-request-id header for log correlation.

Where to go next