clickhouse-connect is a production-grade, high-performance Python database driver for ClickHouse that provides synchronous and asynchronous client APIs, a full DB-API 2.0 interface, and a comprehensive SQLAlchemy dialect with Alembic migration support. The architecture separates transport backends (HTTP, embedded chDB) behind a clean protocol contract (`SyncBackend`/`AsyncBackend`) and offers an optional Rust native codec (`_ch_core`) for critical encoding/decoding paths. Key entry points are `clickhouse_connect.get_client()` (sync) and `clickhouse_connect.get_async_client()`, which return `Client`/`AsyncClient` instances. These expose methods for SQL queries, inserts, commands, streaming, and direct integration with Pandas, NumPy, Apache Arrow, and Polars via dedicated result-type methods (e.g., `query_df`, `query_arrow_stream`). The driver handles ClickHouse-specific features including multiple wire formats (Native, RowBinary, Arrow, Parquet, JSONEachRow), compression (lz4, zstd, brotli, gzip), external data attachments, server-side parameter binding, and advanced data types (JSON, Variant, Dynamic, QBit, Decimal, DateTime64, temporal types with timezone control). External dependencies include `urllib3` (sync HTTP), `aiohttp` (async), `pyarrow` (optional), and the ClickHouse Rust codec wheel (optional but recommended for performance). The codebase is well-tested with both unit and integration tests against live ClickHouse servers, including TLS and proxy configurations.