tree-sitter-sql
Tree-sitter Grammar for SQL
Decision gist · record as of 2026-08-14
Yes, if you need to parse SQL code programmatically and are already using tree-sitter. The package is actively maintained, has no known vulnerabilities, and uses a permissive MIT license. Install friction is moderate due to the requirement for Python 3.10+ and the need to pair it with tree-sitter bindings, but prebuilt wheels are available for common platforms. Not worth installing if you don't need tree-sitter integration or are on Python versions below 3.10.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; tree-sitter Python bindings must be installed separately to actually parse SQL.
- Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (Linux x86_64/aarch64, macOS Intel/ARM, Windows x86_64/ARM) but requires Python 3.10+.
- Active maintenance with recent commits.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and commercial projects.
last release 2025-10-01 (317 days) · last repo commit 2026-03-02 · 243 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,185,061 downloads/mo, #3,227 on PyPI
Alternatives
Verify before relying
pip install tree-sitter-sql
import tree_sitter_sql
# Use with tree-sitter Python bindings to parse SQL- Whether this package includes Python bindings or only provides the grammar for use with external tree-sitter tooling.
- Whether the package works with all SQL dialects or has specific limitations beyond what the description references (SQLite, PostgreSQL, MariaDB).
What it is and what it does
tree-sitter-sql is a tree-sitter grammar module that enables parsing of SQL code into an abstract syntax tree. It provides a general, permissive SQL grammar designed to handle SQL syntax across multiple dialects, drawing from SQLite, PostgreSQL, and MariaDB references. The package is distributed as precompiled wheels for common platforms, reducing installation friction compared to building from source.
The grammar itself is maintained separately from the parser implementation; the package installs the compiled parser binary that tree-sitter tools can use to analyze SQL code. It's intended for developers building SQL analysis tools, linters, formatters, or any system that needs to programmatically understand SQL structure. The package requires Python 3.10+ and has no runtime dependencies beyond tree-sitter itself.
Use it for
- Build SQL linters or formatters that need to parse and understand SQL syntax structure.
- Implement SQL code analysis tools that extract information about queries, tables, or columns.
- Create IDE plugins or editor extensions that provide SQL syntax highlighting or error detection.
- Develop database schema migration tools that parse and transform SQL DDL statements.
- Analyze SQL query performance or security by examining the parsed syntax tree.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to parse SQL code programmatically and are already using tree-sitter.
The package is actively maintained, has no known vulnerabilities, and uses a permissive MIT license. Install friction is moderate due to the requirement for Python 3.10+ and the need to pair it with tree-sitter bindings, but prebuilt wheels are available for common platforms. Not worth installing if you don't need tree-sitter integration or are on Python versions below 3.10.
Install
tree-sitter-sql on PyPI
Before you install
Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (Linux x86_64/aarch64, macOS Intel/ARM, Windows x86_64/ARM) but requires Python 3.10+. Active maintenance with recent commits.
Requires Python 3.10 or later; tree-sitter Python bindings must be installed separately to actually parse SQL.
License in practice
MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and commercial projects.
Quickstart
pip install tree-sitter-sql
import tree_sitter_sql
# Use with tree-sitter Python bindings to parse SQLVerify before relying
- Whether this package includes Python bindings or only provides the grammar for use with external tree-sitter tooling.
- Whether the package works with all SQL dialects or has specific limitations beyond what the description references (SQLite, PostgreSQL, MariaDB).
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 317 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,185,061 / month, #3,227 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseTopic :: Software Development :: CompilersTopic :: Text Processing :: LinguisticTyping :: Typed |
Evidence: tree_sitter_sql-0.3.11-cp310-abi3-macosx_10_9_x86_64.whl; tree_sitter_sql-0.3.11-cp310-abi3-macosx_11_0_arm64.whl; tree_sitter_sql-0.3.11-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; tree_sitter_sql-0.3.11-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl; tree_sitter_sql-0.3.11-cp310-abi3-musllinux_1_2_aarch64.whl; tree_sitter_sql-0.3.11-cp310-abi3-musllinux_1_2_x86_64.whl; tree_sitter_sql-0.3.11-cp310-abi3-win_amd64.whl; tree_sitter_sql-0.3.11-cp310-abi3-win_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “SQL parser tree-sitter”
- tree-sitter-sqlProvides a tree-sitter SQL grammar for parsing SQL code into an…
- tree-sitter-xmlProvides a tree-sitter parser grammar for XML and DTD files, enabling…
- tree-sitter-cssProvides a CSS grammar parser for tree-sitter, enabling incremental…
Give your agent the search over MCP, or paste the wish link into any chat.
More Linguistic packages
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
tiktoken is a fast BPE tokenizer that converts text into token sequences compatible with OpenAI models, supporting multiple encoding schemes including o200k_base and model-specific encodings.
Install it if you work with OpenAI APIs or need to understand token boundaries in GPT-family models.
Detects character encoding and language in byte sequences with high accuracy, supporting 99 encodings and returning confidence scores, language tags, and MIME types.
Install it if you need to detect character encoding or language in byte data; the rewrite makes it substantially faster and more accurate than its predecessors.
Converts Unicode text to ASCII by transliterating non-ASCII characters into their closest ASCII equivalents, with no runtime dependencies.
However, if transliteration quality or ongoing maintenance matters, consider unidecode instead despite its GPL-only license.
Lark is a parsing library that builds abstract syntax trees from context-free grammars, supporting multiple parsing algorithms (Earley, LALR(1), CYK) with automatic line and column tracking.
Python bindings to the tree-sitter parsing library, enabling incremental parsing and syntax tree analysis for source code.
See also tree-sitter-python · tree-sitter-java · syntaqlite · tree-sitter-php · tree-sitter-c · tree-sitter-hcl · tree-sitter-go · tree-sitter-ruby · tree-sitter-zig · tree-sitter-elixir