Skip to content

docs: refine cold-start claim with import-timing numbers #14

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hampsterx merged 1 commit into from
Jul 1, 2026
Merged

docs: refine cold-start claim with import-timing numbers #14

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,10 @@ Code (via `CLAUDE.md`), Codex CLI, and humans.
[SQL API v2](https://docs.snowflake.com/en/developer-guide/sql-api/index) (the
`POST /api/v2/statements` REST endpoint). It exists as a small, fast alternative
to the official `snowflake-connector-python`, which is ~75 MB installed (150 MB
with pandas/pyarrow), has an 8-20 s cold start, and ships a C extension that slows
container builds. This client is pure Python over `httpx`, so it is small and
quick to cold-start, which matters in serverless / Lambda environments.
with pandas/pyarrow) and ships a C extension that slows container builds and
inflates cold starts (its import alone is ~1.5 s versus ~0.3 s for this client).
This client is pure Python over `httpx`, so it is small and quick to cold-start,
which matters in serverless / Lambda environments.

It offers both **synchronous and asynchronous** clients, keypair (JWT) auth, type
coercion, multi-partition result handling, a CLI, and optional pandas / typed-row
Expand Down
7 changes: 4 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,10 @@ A lightweight, pure-Python client for [Snowflake's SQL API v2](https://docs.snow
## Why

The official [`snowflake-connector-python`](https://pypi.org/project/snowflake-connector-python/)
is ~75 MB installed (150 MB with pandas/pyarrow), has an 8-20 s cold start, and
ships a compiled extension that slows container builds. For serverless and AWS
Lambda workloads that only need to run SQL, that is a lot of weight.
is ~75 MB installed (150 MB with pandas/pyarrow) and ships a compiled extension
that slows container builds and inflates cold starts (its import alone is ~1.5 s
versus ~0.3 s for this client). For serverless and AWS Lambda workloads that only
need to run SQL, that is a lot of weight.

`snowflake-sql-api` talks to Snowflake's SQL API over plain HTTP (`httpx`), so it
stays small and cold-starts quickly. Core dependencies: `httpx`, `PyJWT`,
Expand Down
Loading