Skip to content

Tutorials

Hands-on, end to end

The quickstart gets you a verified answer in ten minutes. These tutorials go deeper: each one is a narrow, concrete scenario you build from scratch, with copy-pasteable commands and a checkpoint at every step. Work through them in order, or jump to the one that matches what you are trying to build.

Before you start any of these

Every tutorial assumes a running telha serve and an API key. If you have not done that yet, start with Installation and the Quickstart.

  • 1 · Ingest and ask a verified question

    Ingest a handful of supplier RISK records, ask a plain-English question, and read back a cited, claim-verified answer plus its full trace.

    ~15 min · beginner

    Start

  • 2 · Time-travel with snapshots and compare

    Record a fact, correct it, then ask the same question at two different atTxTime coordinates to see the correction-versus-past-belief payoff. Finish with /v1/snapshot and /v1/compare.

    ~15 min · beginner

    Start

  • 3 · Hybrid semantic and temporal search

    Register an embedding model, ingest text, and run a vector query fused with where and atValidTime. Tune alpha and minScore to see similarity and decay trade off.

    ~20 min · intermediate

    Start

  • 4 · Build an MCP agent

    Connect to Telha's built-in MCP server with a signed token and drive a minimal agent loop: findRecords, generate, getTrace.

    ~20 min · intermediate

    Start

  • 5 · Connect a source system

    Wire up a real connector end to end: app registration, environment variables, seeding the sync chain, and watching synced items land as sourced, provenance-linked records.

    ~30 min · advanced

    Start

What you need for all of them

  • A telha binary (see Installation)
  • A running telha serve instance and an API key (see the quickstart, steps 2-3)
  • curl (every tutorial shows curl first; some also show TypeScript or Python)

Tutorials 3 and 4 additionally need an [llm] and [embedding] provider configured, as covered in quickstart step 7. Tutorial 5 needs credentials for the source system you choose to connect.