ty-extended

ty-extended is Astral's ty with a sandboxed semantic extension system. It keeps the ty command and language server while allowing libraries to contribute library-aware types and diagnostics without linking to checker internals.

Extension showcase

django-ty is a live extension for Django ORM semantics, available now from PyPI. It covers model fields, relations, managers, querysets, lookups, settings, forms, and requests, with its behavior measured against django-stubs in a reproducible differential-conformance suite.

What ships

Distribution	Published at	Purpose
`ty-extended`	PyPI	The `ty` checker and language server with semantic extension loading and WASM execution.
`ty_plugin_sdk`	crates.io · docs.rs	The Rust API used to build an extension: manifest builders, typed hooks, patch helpers, JSON dispatch, and WASM exports.
`ty_plugin_protocol`	crates.io · docs.rs	The stable serialized manifest, request, response, claim, and patch types shared by extensions and the host.

Most extension authors only need ty_plugin_sdk; it re-exports the protocol crate as ty_plugin_sdk::protocol. The Rust implementation lives in the ruff submodule, backed by ruff-extended.

How extensions run

flowchart LR
    subgraph host["ty-extended"]
        checker["ty semantic checker"] -->|claimed hook| router["Extension router"]
        router -->|validated patch| checker
    end

    project["Python project"] --> checker
    config["ty.toml + plugin manifest"] --> router
    router -->|JSON request| wasm["WASM extension<br/>inside Wasmtime"]
    wasm -->|declarative patch| router
    checker --> output["Types + diagnostics"]

The manifest tells ty which symbols and hooks an extension owns. At a matching semantic query, ty serializes a small request, executes the extension inside a Wasmtime sandbox, validates the returned patch, and feeds the result back into type inference. Extensions receive protocol data, not ty's internal types, AST ids, or Salsa database.

Getting started

Run the checker directly with uvx:

uvx --from ty-extended ty check

Or add it to a project:

uv add --dev ty-extended
uv run ty check

See installation, type checking, and editor integration for the regular ty workflow.

Configure extensions

An installed extension package can be discovered from the project's Python environment:

# ty.toml
[plugins]
auto-discover = true

To load a WASM artifact explicitly, configure and trust it for the project:

# ty.toml
[plugins]
enabled = true

[[plugins.plugin]]
id = "my-extension"
path = ".ty/plugins/my_extension.wasm"
runtime = "wasm"
manifest-path = ".ty/plugins/my-extension.plugin.json"
trusted = true

Use [tool.ty.plugins] and [[tool.ty.plugins.plugin]] for the same settings in pyproject.toml. See extension runtime for loading, trust, and sandbox details.

Everything from ty

ty-extended tracks ty's checker and language server. That includes:

fast incremental type checking;
rich diagnostics and configurable rule levels;
gradual typing, advanced narrowing, and intersection types;
editor support for navigation, completion, code actions, auto-imports, inlay hints, and hover;
the same ty check, ty server, configuration, and project discovery behavior.

The upstream ty documentation remains the reference for those shared features.

Documentation

For information on upstream ty's timeline to a stable release, see its Stable milestone.

FAQ

Is ty-extended a separate checker?

It is a fork of ty that preserves the ty CLI and language server and adds semantic extensions.

Why does it execute extensions as WASM?

WASM gives extensions a stable, serialized boundary and lets the host enforce deterministic fuel, memory, and response-size limits without exposing checker internals or ambient system access.

Where are general ty questions answered?

See ty's upstream typing FAQ. The ty-extended FAQ covers only fork and extension behavior.

Getting help

For ty-extended packaging, extension runtime, SDK, or protocol issues, open an issue. For behavior inherited unchanged from ty, check the upstream documentation first.

Contributing

Most implementation work happens in the ruff submodule, which points at regularkevvv/ruff-extended. See the contributing guide for the repository workflow.

Version policy

ty-extended uses SemVer-compatible fork versioning that records the upstream ty base:

upstream 0.0.58 maps to the initial ty-extended 0.58.0 release;
later fork releases on the same upstream base increment the patch, such as 0.58.1 and 0.58.2;
upstream 0.0.59 maps to ty-extended 0.59.0;
later releases on that base increment the patch, such as ty-extended 0.59.1;
upstream 0.0.60 maps to ty-extended 0.60.0;
upstream 0.0.61 maps to ty-extended 0.61.0;
upstream 0.0.62 maps to ty-extended 0.62.0;
upstream 0.0.63 maps to ty-extended 0.63.0;
upstream 0.0.64 maps to ty-extended 0.64.0;
upstream 0.0.65 maps to ty-extended 0.65.0;
upstream 0.0.66 maps to ty-extended 0.66.0;
upstream 0.0.67 maps to ty-extended 0.67.0;
upstream 0.0.68 maps to ty-extended 0.68.0;
upstream 0.0.69 maps to ty-extended 0.69.0;
upstream 0.1.50 maps to ty-extended 0.150.0;
once upstream reaches 1.0.0, ty-extended follows that shape directly as 1.0.x.

The protocol and SDK crates are versioned independently. They are pre-1.0, so breaking changes may occur between any two 0.0.x releases.

License

ty is licensed under the MIT license (LICENSE or https://opensource.org/licenses/MIT).

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in ty by you, as defined in the MIT license, shall be licensed as above, without any additional terms or conditions.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ty_extended-0.69.0.tar.gz (6.7 MB view details)

Uploaded Aug 22, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ty_extended-0.69.0-py3-none-win_arm64.whl (16.1 MB view details)

Uploaded Aug 22, 2026 Python 3Windows ARM64

ty_extended-0.69.0-py3-none-win_amd64.whl (17.6 MB view details)

Uploaded Aug 22, 2026 Python 3Windows x86-64

ty_extended-0.69.0-py3-none-win32.whl (16.0 MB view details)

Uploaded Aug 22, 2026 Python 3Windows x86

ty_extended-0.69.0-py3-none-musllinux_1_2_x86_64.whl (17.3 MB view details)

Uploaded Aug 22, 2026 Python 3musllinux: musl 1.2+ x86-64

ty_extended-0.69.0-py3-none-musllinux_1_2_i686.whl (16.9 MB view details)

Uploaded Aug 22, 2026 Python 3musllinux: musl 1.2+ i686

ty_extended-0.69.0-py3-none-musllinux_1_2_armv7l.whl (15.8 MB view details)

Uploaded Aug 22, 2026 Python 3musllinux: musl 1.2+ ARMv7l

ty_extended-0.69.0-py3-none-musllinux_1_2_aarch64.whl (15.8 MB view details)

Uploaded Aug 22, 2026 Python 3musllinux: musl 1.2+ ARM64

ty_extended-0.69.0-py3-none-manylinux_2_31_riscv64.whl (17.2 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.31+ riscv64

ty_extended-0.69.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (17.2 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.17+ x86-64

ty_extended-0.69.0-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (17.6 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.17+ s390x

ty_extended-0.69.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (17.4 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.17+ ppc64le

ty_extended-0.69.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (17.6 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.17+ i686

ty_extended-0.69.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (15.8 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.17+ ARMv7l

ty_extended-0.69.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (15.9 MB view details)

Uploaded Aug 22, 2026 Python 3manylinux: glibc 2.17+ ARM64

ty_extended-0.69.0-py3-none-macosx_11_0_arm64.whl (15.3 MB view details)

Uploaded Aug 22, 2026 Python 3macOS 11.0+ ARM64

ty_extended-0.69.0-py3-none-macosx_10_12_x86_64.whl (16.4 MB view details)

Uploaded Aug 22, 2026 Python 3macOS 10.12+ x86-64

ty_extended-0.69.0-py3-none-linux_armv6l.whl (16.1 MB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file ty_extended-0.69.0.tar.gz.

File metadata

Download URL: ty_extended-0.69.0.tar.gz
Upload date: Aug 22, 2026
Size: 6.7 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ty_extended-0.69.0.tar.gz
Algorithm	Hash digest
SHA256	`46b3c6afab03ece6205ec547a03f169d51f51101ee9deea7d3b97f4fe3e7b2de`
MD5	`57b1dc90688cb546008f2872d049be7c`
BLAKE2b-256	`4366e504c452124a9762465b53b41cdb2ce7dbe6ddf3f4403fea5569e3fd9b6a`

Algorithm	Hash digest
SHA256	`7a6764d3a6961345dd6e0061144c0d61f7f88cd6b575e4f163c0e7a77f4e0d17`
MD5	`4a8a2268ad27d3be5282235c8da8c653`
BLAKE2b-256	`cc89e67bc9a53f6da6337efd2d9e43a741440fd9e06f464a7236e6c7502f49d7`

Algorithm	Hash digest
SHA256	`c784229aeebd4a75ad543d8c441d599488fdb4551812045c3b81aafdeb1709c0`
MD5	`73b76a191a2efed905dc7c46f054aa7c`
BLAKE2b-256	`f12a441ec3d7d7becd4017c2cda344eeb7ee6951aa4ee9900aba171d81bd68a2`

Algorithm	Hash digest
SHA256	`262c7bc8de85f742ae49dca1508be66e24cb89b6c55a8f94c72dfc3c80bf587f`
MD5	`89098fe0e6d82589ed0787343c0811bf`
BLAKE2b-256	`491b61357f709562a0d9a9cd9eb34144c9fb036152f4c755713e9b7bf4d5fee4`

Algorithm	Hash digest
SHA256	`f591953fc03e1ad2fd4310ac2dfc90cba50a95ddd76dbeaa22613fa901676b54`
MD5	`4b6f64bbf2e3abf6c4cd5b2d79fb3c36`
BLAKE2b-256	`0f3f7924a6a57c2986a55262344573c822befb2f1fcd2bc2ef0c10d0932aedab`

Algorithm	Hash digest
SHA256	`a59753ee73ba2cc1659c51a51938cde2fab0a38aa3fb5107d43c954dbbff515b`
MD5	`bf4fcf89cecbe65b59ab97d10d1d3e18`
BLAKE2b-256	`c5d3bb6cebc7d1156b0375eb3ba5c3e0e49c160b009f30a7b163a82e466c0d78`

Algorithm	Hash digest
SHA256	`2e0ae0bb3ba09c4f749d35a39fbef858bdba30d0bcbf2f57f48880a0893abc48`
MD5	`cd86e037cd46b9e85a08d44d66f8a655`
BLAKE2b-256	`40a927d70325893f83f811fd2a11866d33ef8d6af6219a3c1facddee2fd6d0ca`

Algorithm	Hash digest
SHA256	`f386cc6bdd3f1413f43dcb36602e184c7bea310911a1a2ad3f3e1eb7ce5f03c4`
MD5	`0bca5c61381b09898d8907a087673950`
BLAKE2b-256	`fda87f4a98bc4132df01463380d53219fa911951019406ecee8b233fafd400af`

Algorithm	Hash digest
SHA256	`36a826f78b60859ce331796808faa63abeab8af1be5182da39a10a68fd635cc8`
MD5	`4d9e9ac94f46c9a00279d1354bf6a856`
BLAKE2b-256	`be367449b1619e445d2a9383d5a70a559e0ff3b08df230a08c4ba39e8b999396`

Algorithm	Hash digest
SHA256	`ee57505e9e5e37a16652809dc9087682e7ad92450d08d4ddf2f0e25a88ef8aa1`
MD5	`0558845f1b34c805e08efe69eba63974`
BLAKE2b-256	`9740c957845e58d04d18273bf64af13783ba7ce893b99c25a91a06f09c1e8ad1`

Algorithm	Hash digest
SHA256	`8b6e7e0561aa311954e3dbbc3895ba05f5512e39aabb803d8e7f5896538e6b08`
MD5	`fa595d64507624fc3b5842adb119a7dc`
BLAKE2b-256	`2a87901a92a0cb325f0f5da26a5277884d10a0cf1e7d8f870146276d6be90e7d`

Algorithm	Hash digest
SHA256	`1947648ee8e8f80624e03ad5f4f31cfa5df982e1a0acc1dae009c57012c0a252`
MD5	`93738167967b29251fcf99652308f4cd`
BLAKE2b-256	`74bdbf21b655d22e18f4edf37036441a81ebd680708f9ac008c9c00c1ec4537e`

Algorithm	Hash digest
SHA256	`9cfcbc1d452173b86d36065d6d42616b479f544ccfce715378a043680aab583a`
MD5	`4d4ce3e7b3a65752a469639828a02313`
BLAKE2b-256	`949ef96d14f2ac6229fa3590ba1e64a77b797e35260afa5cc19c56637a27f7b3`

Algorithm	Hash digest
SHA256	`28edbd72e0a381e7e3c41b196598cd80575d755ed4153c7d625a5ff1994dc474`
MD5	`3589be50e2aee738a3fdd98f4f49c88f`
BLAKE2b-256	`1731daa05a313f2ff3ef2436ab9355ef8163f554523489309703460f85507eec`

Algorithm	Hash digest
SHA256	`ca8025c08b04333fcedc797d3e3ebd8b27ea3ef77a4c04e1aace43c652cabf61`
MD5	`a0212d68bea96680d3a5850565839b18`
BLAKE2b-256	`79dffce7c41c7d4166c00b5e1852df7f54d7289502ad135e8b7f9565ebbb792e`

Algorithm	Hash digest
SHA256	`11365a806183300c6ff15213a4ed8eb2bca06490814daa1f52a0201650454a78`
MD5	`b7d936afc469f9593d35f1315b926592`
BLAKE2b-256	`0b28b4e7e53627d386cf306e2ace2cd4d4af4cd6059d3054ce5663d5ed37a2ee`

Algorithm	Hash digest
SHA256	`8a340d7ef2019f593e3619c82cd52a1909bb8710b4e3603f74f800aa258bccf6`
MD5	`049fd5e49d28d14fe8fce483155c145a`
BLAKE2b-256	`53d1bae133280ac4cb291aadc2e131b278202aedc7a1d56baf30dc4ffb335a5c`

Algorithm	Hash digest
SHA256	`fc5a4d69df2c484dc784001aa1c09391ced7b1e2dab5488ec923ed6c834145c5`
MD5	`fcbfe9bc9b1150f90e909409a3028cae`
BLAKE2b-256	`6c9850fea2aa33a7681a7f928159c7bb2bc3fbea4d5ae5a0dd6625112f463c00`

ty-extended 0.69.0

ty-extended

Extension showcase

What ships

How extensions run

Getting started

Configure extensions

Everything from ty

Documentation

FAQ

Is ty-extended a separate checker?

Why does it execute extensions as WASM?

Where are general ty questions answered?

Getting help

Contributing

Version policy

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes