Skip to content
Install

Install Haybarn

Run the DuckDB-compatible CLI through npm, PyPI, or GitHub Releases. Same SQL and database files, with release artifacts your team can review.

Run Haybarn without a global install

Use npx or uvx to fetch and run the CLI temporarily, then try normal DuckDB SQL plus a rebuilt community extension.

terminal · npm 
# Start Haybarn
npx haybarn@rc

# Or run one query and exit
npx haybarn@rc -c "SELECT version();"
terminal · PyPI 
# Start Haybarn
uvx haybarn-cli==1.5.5rc1

# Or run one query and exit
uvx haybarn-cli==1.5.5rc1 -c "SELECT version();"
Haybarn shell 
-- Run these once the Haybarn shell is open.
SELECT 42 AS answer;

-- Try a5, a community extension for pentagonal geospatial indexing.
INSTALL a5 FROM community;
LOAD a5;

SELECT a5_lonlat_to_cell(-122.4194, 37.7749, 10);

On the first npx run, npm may ask for permission to fetch haybarn@rc. Haybarn then opens a SQL shell and the statements below can be pasted straight in.

Once 1.5.5 ships final, drop the @rc and pinned RC suffixes.

Choose the path that fits your workflow

npm / npx

Best for Node-oriented teams and quick CLI trials.

npx haybarn@rc

uvx

Best for Python-oriented teams that want a temporary CLI runner.

uvx haybarn-cli==1.5.5rc1

Direct downloads

Download the CLI, shared library, or static library for your platform from GitHub Releases.

Open GitHub Releases

Download the artifact for your platform, unzip it, then run the haybarn binary.

Python library

Coming soon

Drop-in compatible with the DuckDB Python API once the library publish pipeline is live.

import haybarn as duckdb

Everything Haybarn ships

The CLI, libraries, and signed extensions are available today. Language bindings are rolling out — track them on the status page.

Artifact Name Where Status
CLI haybarn npm · PyPI · GitHub Releases Available
Shared library libhaybarn.{so,dylib,dll} GitHub Releases Available
Static library libhaybarn_static.a GitHub Releases Available
Core extensions Haybarn-signed Haybarn channel · npm Available
Community extensions rebuilt & signed Haybarn channel · npm Available
Python library haybarn PyPI In progress
Node bindings @haybarn/node-neo npm Planned
JDBC driver haybarn-jdbc Maven Planned
WebAssembly haybarn-wasm tracked on status In development

Supported platforms

Platform Build targets
Linux x86-64 · glibc · ARM64 · glibc · x86-64 · musl · ARM64 · musl
macOS Apple Silicon · Intel · Universal
Windows x86-64

Signed extensions additionally build for WebAssembly. Per-platform build status is on the status page.

Verify release artifacts

For casual local use, you can skip this. For production rollouts, Haybarn release artifacts include checksums, signatures, and GitHub build attestations so teams can review where a binary came from.

verify-release.sh 
gh attestation verify haybarn_cli-linux-amd64.zip \
  --repo Query-farm-haybarn/haybarn

Full signing keys and verification steps on the security page.

Replace the filename with the artifact you downloaded.

Build status · Live dashboard

Need help rolling Haybarn out?

Expert help

We help teams with version pinning, internal mirrors, private extension channels, and production rollout.

Consulting Schedule a call