tach
A Python tool to maintain a modular package architecture.
Decision gist · record as of 2026-08-14
Yes, if you maintain a Python monolith or multi-package project and want to prevent architectural drift. The tool is actively maintained, has no runtime overhead, and integrates cleanly into existing workflows. Medium install friction is offset by broad platform support and pre-built wheels. No known vulnerabilities. Start with `tach init` to evaluate fit for your codebase.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Compiled Rust wheels require a compatible platform; pure-Python fallback is not available.
- Medium install friction due to compiled Rust components, but pre-built wheels cover common platforms (macOS, Linux, Windows, multiple architectures).
License · maintenance · safety
permissive license (permissive) — MIT license (permissive) means you can use, modify, and distribute Tach freely with minimal restrictions, making it suitable for both open-source and commercial projects.
last release 2026-05-12 (94 days) · last repo commit 2026-06-11 · 2,788 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 4,988,216 downloads/mo, #2,185 on PyPI
Alternatives
Verify before relying
pip install tach
# In your project root:
tach init
# (Interactive setup: navigate with arrow keys, mark module boundaries with Enter)
tach check
# Output: ✅ All modules validated! (or ❌ with violations)- Whether cp37-abi3 wheels indicate broader Python version support than requires_python >=3.10 suggests
- Performance characteristics when checking large monorepos or projects with thousands of modules
- How incremental adoption works in practice and whether partial enforcement can coexist with legacy code
What it is and what it does
Tach is a Python tool written in Rust that enforces architectural boundaries within a codebase by validating module dependencies, public interfaces, and preventing circular imports. It works by reading a configuration file (tach.toml) where you define module boundaries and their allowed dependencies, then checks your code to ensure imports respect those rules.
You run `tach init` to interactively mark module boundaries in your project, then `tach check` to validate compliance. It integrates with CI/CD pipelines, pre-commit hooks, and IDEs, and provides visualization and reporting commands. The tool has no runtime impact—it only runs during development and testing—and can be adopted incrementally, allowing you to enforce rules on some modules while leaving others unchecked.
Use it for
- Enforce layered architecture in a monolith by preventing lower layers from importing upper layers
- Detect and prevent circular dependencies between modules before they cause import errors
- Define and validate public APIs for modules so internal implementation details stay private
- Visualize your project's dependency graph with `tach show` to understand coupling
- Integrate module boundary checks into CI/CD to catch architectural violations before merge
- Incrementally adopt modular structure in legacy codebases by checking only new or refactored modules
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you maintain a Python monolith or multi-package project and want to prevent architectural drift.
The tool is actively maintained, has no runtime overhead, and integrates cleanly into existing workflows. Medium install friction is offset by broad platform support and pre-built wheels. No known vulnerabilities. Start with `tach init` to evaluate fit for your codebase.
Install
tach on PyPI
Before you install
Medium install friction due to compiled Rust components, but pre-built wheels cover common platforms (macOS, Linux, Windows, multiple architectures). Active maintenance with recent releases; last commit 2026-06-11 and 2788 GitHub stars indicate ongoing development.
Requires Python 3.10 or later. Compiled Rust wheels require a compatible platform; pure-Python fallback is not available.
License in practice
MIT license (permissive) means you can use, modify, and distribute Tach freely with minimal restrictions, making it suitable for both open-source and commercial projects.
Quickstart
pip install tach
# In your project root:
tach init
# (Interactive setup: navigate with arrow keys, mark module boundaries with Enter)
tach check
# Output: ✅ All modules validated! (or ❌ with violations)Verify before relying
- Whether cp37-abi3 wheels indicate broader Python version support than requires_python >=3.10 suggests
- Performance characteristics when checking large monorepos or projects with thousands of modules
- How incremental adoption works in practice and whether partial enforcement can coexist with legacy code
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 8 packagespyyamltomlitomli-wrichprompt-toolkitgitpythonnetworkxpydot |
| Maintenance | Actively maintained 94 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 4,988,216 / month, #2,185 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: Quality Assurance |
Evidence: tach-0.35.0-cp37-abi3-macosx_10_12_x86_64.whl; tach-0.35.0-cp37-abi3-macosx_11_0_arm64.whl; tach-0.35.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; tach-0.35.0-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl; tach-0.35.0-cp37-abi3-manylinux_2_17_i686.manylinux2014_i686.whl; tach-0.35.0-cp37-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl; tach-0.35.0-cp37-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl; tach-0.35.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; tach-0.35.0-cp37-abi3-musllinux_1_2_aarch64.whl; tach-0.35.0-cp37-abi3-musllinux_1_2_armv7l.whl; tach-0.35.0-cp37-abi3-musllinux_1_2_i686.whl; tach-0.35.0-cp37-abi3-musllinux_1_2_ppc64le.whl; tach-0.35.0-cp37-abi3-musllinux_1_2_x86_64.whl; tach-0.35.0-cp37-abi3-win32.whl; tach-0.35.0-cp37-abi3-win_amd64.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 › “python module boundary enforcement”
- tachTach enforces module boundaries, dependency rules, and public…
- oslo.privseposlo.privsep helps applications safely perform privileged operations…
- pytest-archonPytest-archon lets you define and test architectural boundaries in…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also import-linter · pytest-archon · fawltydeps · cyclic · import-deps · type-enforced · py-import-cycles · toposort · oslo.policy · PyTestArch