chdb-io

chdb-io/chdb

Cursor rule Cursor

See AGENTS.md for chdb-ds design and testing principles.

chdb-io/chdb

Cursor rule Cursor

See CONTRIBUTING.md for the full contributor guide, including the crash-diagnosis rule (always capture the stack trace before changing code on SIGSEGV / SIGABRT / SIGFPE / SIGILL / SIGBUS / SIGSYS).

chdb-io/chdb

Cursor rule Cursor

See CONTRIBUTING.md → "PR & commit conventions" for PR title format, commit messages, and branch naming.

chdb-io/chdb

Instructions file CodexOpenCode

Instructions for chdb-io/chdb, covering agents.md — chdb, 1. fully lazy execution architecture, 2. natural execution triggering (explicit calls prohibited), 3. unified architecture, simplicity first and 4. testing principles.

chdb-io/chdb

Skill Claude CodeCodex

Use when the user has tabular data (pandas DataFrame, parquet, csv, Arrow, json) and wants to filter, group, aggregate, join, or speed up slow pandas. Provides chDB DataStore — same pandas API, ClickHouse engine underneath. Also handles reading from S3, MySQL, PostgreSQL, MongoDB, ClickHouse Cloud, Iceberg, Delta Lake…

chdb-io/chdb

Skill Claude CodeCodex

Use when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse Cloud, Iceberg, Delta Lake) without setting up a server. Provides chDB — embedded ClickHouse SQL in Python with 1000+ functions, Session for…

chdb-io/chdb

Agent

One behavior, many bindings. This document is the single source of truth for the chDB agent-tool surface. chdb.agents.ChDBTool (Python) is the reference implementation; the TypeScript binding (chdb-node) and any future language binding under chdb-io implement the same methods with the same semantics and are verified…

chdb-io/chdb-mcp

MCP server Claude CodeCodexCursor

MCP server for chDB — the in-process SQL OLAP engine powered by ClickHouse. Lets AI agents query Parquet, CSV, JSON, and pandas DataFrames with one tool. Runs locally from the chdb-mcp Python package.