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.
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.