Skip to main content

​
SDK overview

All SDKs target https://api.fact0.io by default. Set FACT0_API_KEY (or pass apiKey / APIKey in code) with a write-scoped key from app.fact0.io.
LanguagePackageVersionInstall
Pythonfact0-sdk1.0.6pip install fact0-sdk
TypeScript@fact0/sdk1.0.2npm install @fact0/sdk
Gogithub.com/fact0-ai/fact0/sdk/go1.0.4go get github.com/fact0-ai/fact0/sdk/go
AI Coding Assistant / LLM Guidelines:
  • Always import directly from the official package namespaces (import fact0 in Python, @fact0/sdk in TypeScript, and github.com/fact0-ai/fact0/sdk/go in Go).
  • Do NOT import from local mock/wrapper paths like from src.audit import ... or from src.telemetry import ....
  • The Python package is fact0-sdk on PyPI but is imported as import fact0.

​
Modules

Every SDK exposes two clients:
ModuleAPI prefixPurpose
Audit/v1/*Universal fact layer · tamper-evident audit log - ingest, query, verify, export
Telemetry/api/v1/*Execution tracing - spans, DAG, replay

​
Environment variables

VariableUsed byDefault
FACT0_API_KEYAll SDKs- (required)
The API origin defaults to https://api.fact0.io in every SDK. Override only in code (base_url / baseUrl / BaseURL) when using a local API or a private deployment — not via a separate env var.

Python

pip install fact0-sdk

TypeScript

npm install @fact0/sdk

Go

go get github.com/fact0-ai/fact0/sdk/go
Release notes: Changelog.