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.

Haybarn v1.5.3-rc1 · release candidate for DuckDB v1.5.3

Quickstart

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

# Or run one query and exit
uvx haybarn-cli==1.5.3rc1 -c "SELECT version();"
Haybarn shell
-- Run this after Haybarn opens at the memory H prompt.
SELECT 42 AS answer;

-- Try h3, a community extension for H3 geospatial indexing.
INSTALL h3 FROM community;
LOAD h3;

SELECT h3_latlng_to_cell(37.7887, -122.3931, 9);

On the first npx run, npm may ask for permission to fetch haybarn@rc. After Haybarn starts, run SQL at the memory H prompt.

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

Install paths

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

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

What you get

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

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.

Optional for teams

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

Expert help

Need help rolling Haybarn out?

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