ty-extended

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

Plugin showcase

django-ty is a live plugin 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 plugin loading and WASM execution.
`ty_plugin_sdk`	crates.io · docs.rs	The Rust API used to build a plugin: 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 plugins and the host.

Most plugin 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 plugins run

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

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

The manifest tells ty which symbols and hooks a plugin owns. At a matching semantic query, ty serializes a small request, executes the plugin inside a Wasmtime sandbox, validates the returned patch, and feeds the result back into type inference. Plugins 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 plugins

An installed plugin 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-plugin"
path = ".ty/plugins/my_plugin.wasm"
runtime = "wasm"
manifest-path = ".ty/plugins/my-plugin.json"
trusted = true

Use [tool.ty.plugins] and [[tool.ty.plugins.plugin]] for the same settings in pyproject.toml. See plugin 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 plugins.

Why does it execute plugins as WASM?

WASM gives plugins 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 plugin behavior.

Getting help

For ty-extended packaging, plugin 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.0.70 maps to ty-extended 0.70.0;
upstream 0.0.71 and 0.0.72 were merged but not released: both abort on deeply nested expressions, which upstream fixed in 0.0.73;
upstream 0.0.73 maps to ty-extended 0.73.0;
upstream 0.0.74 maps to ty-extended 0.74.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.74.0.tar.gz (6.9 MB view details)

Uploaded Aug 24, 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.74.0-py3-none-win_arm64.whl (16.5 MB view details)

Uploaded Aug 24, 2026 Python 3Windows ARM64

ty_extended-0.74.0-py3-none-win_amd64.whl (18.0 MB view details)

Uploaded Aug 24, 2026 Python 3Windows x86-64

ty_extended-0.74.0-py3-none-win32.whl (16.5 MB view details)

Uploaded Aug 24, 2026 Python 3Windows x86

ty_extended-0.74.0-py3-none-musllinux_1_2_x86_64.whl (17.7 MB view details)

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

ty_extended-0.74.0-py3-none-musllinux_1_2_i686.whl (17.3 MB view details)

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

ty_extended-0.74.0-py3-none-musllinux_1_2_armv7l.whl (16.3 MB view details)

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

ty_extended-0.74.0-py3-none-musllinux_1_2_aarch64.whl (16.2 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_31_riscv64.whl (17.6 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (17.5 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (17.9 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (17.8 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (18.0 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (16.3 MB view details)

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

ty_extended-0.74.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (16.2 MB view details)

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

ty_extended-0.74.0-py3-none-macosx_11_0_arm64.whl (15.7 MB view details)

Uploaded Aug 24, 2026 Python 3macOS 11.0+ ARM64

ty_extended-0.74.0-py3-none-macosx_10_12_x86_64.whl (16.8 MB view details)

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

ty_extended-0.74.0-py3-none-linux_armv6l.whl (16.6 MB view details)

Uploaded Aug 24, 2026 Python 3

File details

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

File metadata

Download URL: ty_extended-0.74.0.tar.gz
Upload date: Aug 24, 2026
Size: 6.9 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.74.0.tar.gz
Algorithm	Hash digest
SHA256	`b41a87f140bf8f0da69e97bc2aecd133d7b490744d5660e95daef29f540a5f03`
MD5	`f73b8a71a3777e945df7d5a296419fa4`
BLAKE2b-256	`1bfcbbbf54fae46b6f2a06f98fd90d861fdfa15118fee087ff0914cbf38a42e5`

Algorithm	Hash digest
SHA256	`135ad01f0be4984a4a9fc87743e2f7d6bb7215da36e375ef83a6e429e95c93c3`
MD5	`a31331a13a684870159039f122f981b4`
BLAKE2b-256	`d1c1a9f804e5e1d3fa708344185b449b4d6ff256bbe9cc5f5d88c8a6612440c2`

Algorithm	Hash digest
SHA256	`da91c78acc35d9430c39a3ed606102d2c7efce742017fce8c73de82c93567835`
MD5	`4df3db31eb1689e40276d99486b84775`
BLAKE2b-256	`4f27f6354db7cb5888758d57ba74e76d93339a6ad18aadae2293df62162bb586`

Algorithm	Hash digest
SHA256	`293871ee4f7f7bb360b852e5283af4086b24bcd2321a69470539bb3e96c92dba`
MD5	`fd0230ea3bb2f4ee13049f9c8135fb4b`
BLAKE2b-256	`1bcf3775d67938637936fbd650cc113351d562c0c31c5fc4c0b958c5589e3ff3`

Algorithm	Hash digest
SHA256	`0d2dd4836c9d7a7bc9129396a3484a5b1002350e3f2bdfa7204c0eeafbc5666c`
MD5	`c86d4680d2f8863f1e41d96ed63bce45`
BLAKE2b-256	`010bd5799f63f08bb68faf48dcda85c0a758302537c611fe361b4d4e06ca571f`

Algorithm	Hash digest
SHA256	`239bf3f87d4457af31ffc08d3c3cdc006c28441a43ac283bfa9e23877bf38261`
MD5	`4628f7d75f6013d445dc555bd1b992f6`
BLAKE2b-256	`eb3e5dea7643232ed975ec090329ef8ebce003c0ae382ae12d7dae939f4c015a`

Algorithm	Hash digest
SHA256	`9a259f4edfa5b8357f656a27b9e226abff83bb0927d2ee61a649641bb3ab9126`
MD5	`cc4a77222946dd535eddd3333e5b4e13`
BLAKE2b-256	`6c87504cd37f773b718434e0d4c375c94d4de17fee20f2ec4cd2286de8615baf`

Algorithm	Hash digest
SHA256	`0ccfa64f10fab541998367f54ba1dacb097c46d81c56ded1e28760aeb750c643`
MD5	`21aa07c2c15c903ebb63c69acc7c2643`
BLAKE2b-256	`cad39d10c29c9fe5a75670d430c4eedb1ec2dae4726bbe0082a9a8678300b26c`

Algorithm	Hash digest
SHA256	`642ac8d29f4b37c620ff0f37fa82a90cccded1e5b5917c6e4925f6d507658938`
MD5	`dcb5c9ade77c8a811db7fd9e86d460a6`
BLAKE2b-256	`316f98a4bf68000f560d83d6a00fae964bf46a30330dd647905ad60aaa16b4a1`

Algorithm	Hash digest
SHA256	`2e00f72dda34c07ee090081ef0f14092de9b7303799bc6ba8518661d25f14d6c`
MD5	`c839e40574ea8b432c2e48b95591802c`
BLAKE2b-256	`0531684f3580dc9f7cfc2d5a4987f25d9f754832af5aa861346f1c5f97fe361d`

Algorithm	Hash digest
SHA256	`5014ed195c4052a4cf22fcac73042cba50432b2a4fec375d9a30eeb384b24844`
MD5	`63b1068fcf2fc8d24d9e0ba4a368eac4`
BLAKE2b-256	`efdf26b8c0be4583a374541ffa92ed6c0d8e9ce38436179cc91defed8b178dda`

Algorithm	Hash digest
SHA256	`42df05f4c9b687640690aac8490e8bdcd04a1000b98e98d090544cb74a7d7778`
MD5	`df2896d048ac206778994d329bdf486e`
BLAKE2b-256	`f05a63a73992293e4c15b196b9919c7cea545d17763efe55b5da16d37e6d5e49`

Algorithm	Hash digest
SHA256	`62109823cae916240faea2f11952706191bd27466572041b1dd59447d90e66c7`
MD5	`efdb7429e764600577fb794ebd4110e2`
BLAKE2b-256	`30b6a6cf4b358a24983806090b8629a962a7849f7ea7e0902bcaad8ece2374f6`

Algorithm	Hash digest
SHA256	`ca4f7143c72be72ff83c3c20905f0ed27b614ec25386f53133e1b8a6c5b8c3ea`
MD5	`4697aa6017486d778ffd5cd97567e4dc`
BLAKE2b-256	`d873f2ce807ea8d5f5a3ebd455e439573454f213a595ae74cd3dabaf81726240`

Algorithm	Hash digest
SHA256	`61cac439b306daa431f8ab76fdfca30402e33ce36eb97e1c9217cb2bb1791d99`
MD5	`825afe87f1c334c6ed6856c753f2dd2a`
BLAKE2b-256	`14d21a5c587380da01344a2d0461c46cb5fe4c24c98da852696125504e8ea8f8`

Algorithm	Hash digest
SHA256	`892bb798f052165dd4812df7a4a76d92b2d576f847a770637b4b7d4244d3423c`
MD5	`da3684dac00d1a258b32e19f9f249336`
BLAKE2b-256	`73ccebbe67960198af9925acf8b3d435c4ae4f4fc47ce0454bc2e0c4fe195302`

Algorithm	Hash digest
SHA256	`e64a985bb37412db21936dd94d31e35bef32d30a86f918bcd41b6fa65508f8f3`
MD5	`a8e9f7a95c56ad131db9a2f4afbf6712`
BLAKE2b-256	`3b5b79cd023f3ec2e82552f85800496bb040d6804209ef55763fa11c0a6d3366`

Algorithm	Hash digest
SHA256	`abfc04df332d1cfa4c50771536c60ef68c454ef5dd22cf132994b3984bebbeac`
MD5	`63cb43d9abbc246aec86af27a7ea8491`
BLAKE2b-256	`fc303727cd553851ba158699d5ff11848ba5fce54157080ef6077218fc0f56c5`

ty-extended 0.74.0

ty-extended

Plugin showcase

What ships

How plugins run

Getting started

Configure plugins

Everything from ty

Documentation

FAQ

Is ty-extended a separate checker?

Why does it execute plugins 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