tree-sitter-java
Java grammar for tree-sitter
Decision gist · record as of 2026-08-14
Yes, if you need programmatic Java parsing with incremental updates. The package is stable, permissively licensed, and has no runtime dependencies. Install friction is moderate due to compilation, but prebuilt wheels are available for common platforms. The aging maintenance status (601 days since release) is not a blocker for a grammar binding, which changes less frequently than application code, but verify that the Java grammar version meets your feature requirements.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later; tree-sitter framework must be installed separately.
- Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (macOS x86_64/arm64, Linux x86_64/aarch64, Windows x64/arm64) but requires Python 3.9+.
- Package is aging (601 days since last release) but repository remains active with recent commits.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both open-source and proprietary projects.
last release 2024-12-21 (601 days) · last repo commit 2025-12-15 · 273 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 10,836,915 downloads/mo, #1,432 on PyPI
Alternatives
Verify before relying
pip install tree-sitter-java
from tree_sitter_java import language- Whether tree-sitter Python bindings are automatically pulled in or must be manually installed.
- Performance characteristics for large codebases or real-time parsing scenarios.
- Completeness of Java grammar coverage (e.g., Java 17+ features, records, sealed classes).
- How to instantiate and use the language grammar once imported.
What it is and what it does
tree-sitter-java is a language grammar binding that integrates Java parsing into the tree-sitter incremental parsing framework. It allows you to parse Java source code into a syntax tree that can be queried and analyzed programmatically. The package provides precompiled wheels for multiple platforms, reducing installation complexity compared to building from source.
The package is part of the broader tree-sitter ecosystem and is used primarily by developers building code analysis tools, linters, refactoring utilities, or IDE features that need to understand Java syntax. It has no runtime dependencies and supports current Python versions starting from 3.9.
Use it for
- Build a code analysis tool that traverses Java syntax trees to detect patterns or enforce style rules.
- Implement a Java refactoring utility that parses and transforms Java source code programmatically.
- Create an IDE plugin or language server that needs fast, incremental parsing of Java files.
- Extract metrics or metadata from Java codebases by querying the parsed syntax tree.
- Develop a code formatter or linter that understands Java grammar structure.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need programmatic Java parsing with incremental updates.
The package is stable, permissively licensed, and has no runtime dependencies. Install friction is moderate due to compilation, but prebuilt wheels are available for common platforms. The aging maintenance status (601 days since release) is not a blocker for a grammar binding, which changes less frequently than application code, but verify that the Java grammar version meets your feature requirements.
Install
tree-sitter-java on PyPI
Before you install
Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (macOS x86_64/arm64, Linux x86_64/aarch64, Windows x64/arm64) but requires Python 3.9+. Package is aging (601 days since last release) but repository remains active with recent commits.
Requires Python 3.9 or later; tree-sitter framework must be installed separately.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both open-source and proprietary projects.
Quickstart
pip install tree-sitter-java
from tree_sitter_java import languageVerify before relying
- Whether tree-sitter Python bindings are automatically pulled in or must be manually installed.
- Performance characteristics for large codebases or real-time parsing scenarios.
- Completeness of Java grammar coverage (e.g., Java 17+ features, records, sealed classes).
- How to instantiate and use the language grammar once imported.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Aging 601 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 10,836,915 / month, #1,432 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_java-0.23.5-cp39-abi3-macosx_10_9_x86_64.whl; tree_sitter_java-0.23.5-cp39-abi3-macosx_11_0_arm64.whl; tree_sitter_java-0.23.5-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; tree_sitter_java-0.23.5-cp39-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl; tree_sitter_java-0.23.5-cp39-abi3-musllinux_1_2_x86_64.whl; tree_sitter_java-0.23.5-cp39-abi3-win_amd64.whl; tree_sitter_java-0.23.5-cp39-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 › “java parser tree-sitter”
- tree-sitter-javaProvides a Java language grammar for tree-sitter, enabling…
- 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 javalang · tree-sitter-c-sharp · tree-sitter-cmake · tree-sitter-cpp · tree-sitter-css · tree-sitter-embedded-template · tree-sitter-fortran · tree-sitter-go · tree-sitter-html · tree-sitter-javascript