libCows

Independent builder generating a stable chdb compatible library binding for C/C++/Go/Rust/Node/Bun/etc

Features

• In-process SQL OLAP Engine, powered by chdb/ClickHouse
• Library only designed for native bindings and integrations
• Compatible with chdb bindings without python obsession.
• Same source code and featureset as chdb/ClickHouse.

:package: Installation

Install libcows manually on x64 or arm64 Linux platforms:

Linux

📦 x86_64

wget https://github.com/cowsdb/libcows/releases/latest/download/libcows.zip
unzip libcows.zip
mv libcows.so /usr/lib/libcows.so

📦 arm64

wget https://github.com/cowsdb/libcows/releases/latest/download/libcows_arm64.zip
unzip libcows_arm64.zip
mv libcows.so /usr/lib/libcows.so

Packages

Install libcows on any deb or rpm based operating system:

:package: Debian Repository (x64/arm64)

wget -q -O - https://cowsdb.github.io/libcows_installer.sh | sudo bash
sudo apt install libcows

:package: RPM Repository (x64/arm64)

wget -q -O - https://cowdb.github.io/libcows_installer.sh | sudo bash
sudo yum install -y libcows

:octocat: Usage

A basic libcows usage example is included with this repository:

cd example
./run.sh

🚧: Project Status

• [x] patch builder, bypass python bindings
• [x] package library as deb, rpm
• [x] host package repository on github pages/actions
• [x] arm64 library support
• [x] header files and examples
• [x] split from chdb-io after they used us up