sqlc-bin

Unofficial. This is a community-maintained packaging project. It is not affiliated with or endorsed by the sqlc authors. Please file issues about this package here, not against sqlc-dev/sqlc.

sqlc as a pip-installable package. Ships the unmodified upstream release binaries, so no Go toolchain is required.

sqlc generates fully type-safe code from SQL. This package exists so Python projects (and anyone without Go installed) can get the sqlc CLI straight from PyPI and pin it like any other dependency.

Installation

# with uv
uv add --dev sqlc-bin        # as a project dev dependency
uv tool install sqlc-bin     # as a global tool

# with pip
pip install sqlc-bin

# with pipx
pipx install sqlc-bin

# run without installing
uvx --from sqlc-bin sqlc version

Usage

Exactly like a go installed sqlc: the sqlc command is on your PATH.

sqlc version
sqlc init
sqlc generate

It also works as a Python module:

python -m sqlc_bin generate

See the sqlc documentation for everything the CLI can do.

Supported platforms

Each platform gets its own wheel with the matching binary inside; pip/uv picks the right one automatically. On any other platform, installation falls back to the sdist, which downloads the binary for the host at build time (and fails clearly if sqlc doesn't publish one).

Versioning

The package version tracks the sqlc version: sqlc-bin==1.31.1 ships sqlc v1.31.1. Packaging-only fixes are published as post-releases (1.31.1.post1) containing the same binary.

How it works

• Wheels bundle the unmodified binaries from sqlc's GitHub releases. Nothing is rebuilt, patched, or recompiled.
• Every downloaded archive is verified against sha256 checksums pinned in checksums.json before packaging.
• The sqlc entry point execs the bundled binary

Development

uv sync                                          # set up the dev environment
uv build --wheel                                 # build a wheel for your platform
SQLC_BIN_TARGET=windows_arm64 uv build --wheel   # cross-build for another target
uv run --with dist/*.whl pytest                  # tests run against an installed wheel
uv run --no-project scripts/bump_sqlc.py         # update to the latest sqlc release

Releases are built and published to PyPI by GitHub Actions (.github/workflows/release.yml) on version tags, using trusted publishing. A daily workflow checks for new sqlc releases and opens a bump PR.

License

The packaging code in this repository is MIT-licensed (LICENSE).

sqlc itself is a separate project by its own authors, licensed under the MIT license — see LICENSE-sqlc (Copyright (c) Riza, Inc.), which covers the bundled binaries and is shipped inside every wheel. "sqlc" is the name of the upstream project; this package is not affiliated with, endorsed by, or sponsored by the sqlc authors.