cowsdb / libcows

Library builder for CowsDB, a non-commercial, community powered chdb/ClickHouse embedded alternative.

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.

📦 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:

📦 Debian Repository (x64/arm64)

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

📦 RPM Repository (x64/arm64)

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

Usage

A basic libcows usage example is included with this repository:

cd example
./run.sh

🚧: Project Status

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