Astral's Python toolchain
Astral publishes three projects for the Python ecosystem, documented together at docs.astral.sh under the heading "Next-gen Python Tooling". uv is a Python package and project manager, Ruff is a Python linter and code formatter, and ty is a Python type checker and language server. All three are written in Rust and are developed as open-source projects on GitHub. The documentation site also links to a Discord community for questions and support, and to updates from the Astral team.
- uv — package and project manager
- Ruff — linter and code formatter
- ty — type checker and language server
- All three written in Rust
- Repositories hosted on GitHub
uv: packages, projects and Python versions
uv is described as a single tool intended to replace pip, pip-tools, pipx, poetry, pyenv, twine and virtualenv, and is documented as 10-100x faster than pip. It manages project dependencies and environments with a universal lockfile, supports Cargo-style workspaces, and runs single-file scripts with inline dependency metadata. uv also installs and manages Python versions, and runs or installs tools published as Python packages. It is installable via a standalone curl or PowerShell installer, as well as pip and Homebrew, without requiring Rust or Python, and supports macOS, Linux and Windows.
- Universal lockfile and comprehensive project management
- uv init, uv add, uv run, uv lock and uv sync commands
- Runs scripts in isolated virtual environments
- Installs and manages Python versions
- pip-compatible interface with a familiar CLI
- Global cache for dependency deduplication
- Supports macOS, Linux and Windows
Ruff: linting and formatting Python code
Ruff combines a linter and a code formatter behind one CLI, with ruff check as the linter entrypoint and ruff format as the formatter entrypoint. The linter is designed as a drop-in replacement for Flake8 plus dozens of plugins, isort, pydocstyle, pyupgrade and autoflake, while the formatter targets drop-in parity with Black. The documentation states Ruff supports over 900 lint rules, each re-implemented in Rust as a first-party feature, with built-in caching and automatic fixes via --fix. Ruff is installable via pip, states Python 3.15 compatibility, and is used in projects including Apache Airflow, Apache Superset, FastAPI, Hugging Face, Pandas and SciPy.
- Over 900 built-in lint rules, defaults including F, E, B, UP and RUF
- Flake8-style rule codes such as F401
- ruff check --fix and --watch options
- ruff format and ruff format --check
- Built-in caching to skip unchanged files
- First-party editor integrations including VS Code
- Online playground for trying rules
ty: type checking and language server
ty is a Python type checker and language server written in Rust, described as 10x to 100x faster than mypy and Pyright. It produces diagnostics with contextual information and supports configurable rule levels, per-file overrides, suppression comments and first-class project support. The language server provides code navigation, completions, code actions, auto-import, inlay hints and on-hover help, with fine-grained incremental analysis for editing in an IDE. It can be run without installation using uvx ty check, which checks all Python files in the working directory or project by default.
- Editor integrations for VS Code, PyCharm and Neovim
- Designed for adoption, including partially typed code
- Advanced typing features such as intersection types and type narrowing
- Online playground for sharing snippets
- Run quickly with uvx ty check
Configuration and compatibility
Ruff is configured through a pyproject.toml, ruff.toml or .ruff.toml file, with the same configuration strategy for linting and formatting. Default settings include a line length of 88, four-space indentation, double quotes and a list of commonly ignored directories, alongside hierarchical and cascading configuration for monorepos. The Settings reference enumerates options such as builtins, cache-dir, exclude, extend, fix and include. The FAQ notes that the Ruff linter is compatible with Black out of the box when the line-length setting is consistent, and that over 99.9% of lines are formatted identically when the formatter is run over extensive Black-formatted projects such as Django and Zulip.
- Config via pyproject.toml, ruff.toml or .ruff.toml
- Default line-length of 88 and indent-width of 4
- Rule selection through lint.select, lint.extend-select and lint.ignore
- --config CLI flag and argfile support
- Shell autocompletion
Contributing
Ruff accepts community contributions through its GitHub repository, with a separate contributing guide for ty. Issues suitable for newcomers are labelled good first issue, while help wanted marks tasks that require varying levels of experience with Rust and the Ruff codebase. Issues labelled needs-decision or needs-design are not considered good candidates, and new features require prior discussion before a pull request is opened. All use of AI in contributions must follow the project's AI policy.
- good first issue and help wanted labels
- No pull requests for new features without prior discussion
- Rust workspace split into crates such as ruff_linter and ruff_formatter
- AI policy applies to all contributions
Sources
Last verified 03 Nov 2026. This entry is compiled from the public web pages listed above. Nothing here is stated that those pages do not, and each of them was read on the date shown.