Threads AI
GuidesLearnAPI ReferenceHTTP API

postgres

The log and artifact store on Postgres: every host process on every machine points at the same database.

Opens lazily: nothing connects until first use, which creates the schema in an empty database and refuses one of another store version or a server before Postgres 16 (unsupported_format). Artifacts are rows of the database. localMemory() and localKnowledge() are refused on it.

Import from @threads/postgres (TypeScript) or threads.postgres (Python).

function postgres(url?: string): Store

Parameters

urlstring

A postgres:// connection URL. Omitted: DATABASE_URL. With neither, the first use is invalid_config naming DATABASE_URL.

Returns

Store

Throws ConfigError with one of these codes: invalid_config.

Edit on GitHub

otel

An Exporter that sends each span of every thread in the store once, when it closes, to an OpenTelemetry collector over OTLP/HTTP JSON.

supermemory

A MemoryProvider that stores records in Supermemory.

On this page

ParametersReturns