syvain-metrics-duckdb

DuckDB extension that attaches Syvain Metrics as a database, bundled per platform with a load() helper.

import duckdb
import syvain_metrics_duckdb

con = duckdb.connect(config={"allow_unsigned_extensions": "true"})
syvain_metrics_duckdb.load(con)
con.execute("CREATE SECRET syvain (TYPE syvain_metrics, API_KEY 'ak_...')")
con.execute(
    "ATTACH 'metrics.syvain.com' AS m (TYPE syvain_metrics, CACHE_DIR '~/.syvain-metrics/duckdb-cache')"
)
print(con.sql("SELECT slug, status FROM m.experiments LIMIT 5"))

The wheel pins the exact DuckDB release the extension was built for. The extension is not signed by DuckDB, so the connection has to allow unsigned extensions before load().

The SQL surface, selector rules, and cache behaviour are documented at https://metrics.syvain.com/docs.