Thyme
Getting Started

Installation

Install the Thyme SDK and set up local infrastructure.

Requirements

  • Python 3.12+
  • uv (recommended) or pip

Install the SDK

uv add thyme-sdk
pip install thyme-sdk

Verify

thyme version
# thyme 0.1.0

Infrastructure (for local development)

Thyme's engine requires Kafka (or Redpanda) and Postgres. The quickest way to run these locally is via the provided Docker Compose setup:

# Clone the Thyme repo (for the docker-compose.yml)
git clone https://github.com/your-org/thyme
cd thyme

# Start Postgres + Redpanda
make infra

# Run migrations
make migrate

Then start the three services in separate terminals:

make run-definition-service   # Control plane on :8080
make run-engine               # Streaming engine
make run-query-server         # Query server on :8081

For a self-contained end-to-end example, see Quick Start.

Why Thyme

The problem every ML team hits — and how Thyme solves it.

Quick Start

Get from zero to a working feature query in under five minutes.

On this page

RequirementsInstall the SDKVerifyInfrastructure (for local development)