Skip to main content

Installation

duckfn_kuva needs DuckDB 1.3 or newer. It is an ordinary loadable extension, so INSTALL and LOAD are all it takes; there is no separate download, library or setup step.

From the community repository​

The simplest route, and the only one that needs no flags:

INSTALL duckfn_kuva FROM community;
LOAD duckfn_kuva;

DuckDB downloads a build that is signed and matched to your DuckDB version and platform. INSTALL is a one-time step, but LOAD is needed again in each new session.

About this route

INSTALL … FROM community works once the extension has been registered in DuckDB's community repository. That registration is a maintainer step described in Community extensions; until it is done, load a release file or a local build instead.

From a GitHub release​

Every version is published as a GitHub Release carrying one .duckdb_extension per platform, named duckfn_kuva-<platform>.duckdb_extension (windows_amd64, linux_amd64, osx_arm64, and so on), plus a WebAssembly build for the browser. Download the one matching your platform and rename it to duckfn_kuva.duckdb_extension before loading it — LOAD takes an extension name or a local path (it fetches no URLs; that is what INSTALL '<url>' is for), and DuckDB takes the entry-point symbol from the file name, so the release name fails with did not contain function "duckfn_kuva-windows_amd64_init_c_api":

curl -LO https://github.com/shijianjs/duckfn-kuva/releases/latest/download/duckfn_kuva-windows_amd64.duckdb_extension
mv duckfn_kuva-windows_amd64.duckdb_extension duckfn_kuva.duckdb_extension
duckdb -unsigned -c "LOAD './duckfn_kuva.duckdb_extension';"

A release file is not signed by DuckDB's distribution key, hence -unsigned.

From a local build​

If you built the extension from source yourself, point LOAD at the artifact — and, again, start DuckDB with -unsigned:

LOAD './build/debug/duckfn_kuva.duckdb_extension';

Building it is the subject of the Development guide.

Checking that it loaded​

duckdb_extensions() lists what is available, and duckdb_functions() what is callable:

SELECT extension_name, installed, loaded
FROM duckdb_extensions()
WHERE extension_name = 'duckfn_kuva';
SELECT function_name, function_type, return_type
FROM duckdb_functions()
WHERE function_name = 'kuva_render';

One row per function; if the list is empty, the extension is not loaded in the session you are querying.