pywatchman
Watchman client for Python
Decision gist · record as of 2026-08-14
Yes, if you need file-watching capabilities and are willing to manage the Watchman daemon separately. The client itself is stable, permissively licensed, actively maintained, and has no dependency overhead. Verify that Watchman is available on your target platform and that you understand the daemon-vs-client architecture before committing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Watchman daemon to be installed and running on the system; pywatchman is only the client library.
- Medium install friction due to platform-specific wheels (macOS arm64 binaries provided); no runtime dependencies.
- Active maintenance with recent release 63 days ago and ongoing repository activity.
License · maintenance · safety
permissive license (permissive) — Permissive BSD-style license (with portions under MIT from the 'six' project) allows commercial and private use with attribution; no copyleft restrictions.
last release 2026-06-12 (63 days) · last repo commit 2026-08-14 · 13,672 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 493,246 downloads/mo, #6,356 on PyPI
Alternatives
Verify before relying
pip install pywatchman
import pywatchman
client = pywatchman.client()
result = client.query('watch-project', '/path/to/watch')- Whether Watchman daemon must be installed separately on the system for pywatchman to function
- Supported platforms beyond the macOS arm64 wheels shown in friction evidence
- Whether this is a pure Python client or requires compiled components on other platforms
What it is and what it does
pywatchman is a Python client library for interacting with Watchman, Meta's file watching service. It provides a programmatic interface to monitor filesystem changes across Windows, macOS, and Linux. The package itself has no runtime dependencies and is maintained by Meta's source control team.
Watchman watches files and records when they change, then can trigger actions like rebuilding assets in response. The Python client lets developers integrate file-watching capabilities into build systems, development tools, and automation scripts. It supports modern Python versions and is marked as production-stable.
Use it for
- Integrate file watching into build systems to trigger asset rebuilds when source files change
- Monitor project directories in development tools to detect when to re-run tests or linters
- Watch for filesystem changes in automation scripts that need to react to file modifications
- Build file-change-triggered workflows in IDEs or editor plugins via the Watchman service
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need file-watching capabilities and are willing to manage the Watchman daemon separately.
The client itself is stable, permissively licensed, actively maintained, and has no dependency overhead. Verify that Watchman is available on your target platform and that you understand the daemon-vs-client architecture before committing.
Install
pywatchman on PyPI
Before you install
Medium install friction due to platform-specific wheels (macOS arm64 binaries provided); no runtime dependencies. Active maintenance with recent release 63 days ago and ongoing repository activity.
Requires Watchman daemon to be installed and running on the system; pywatchman is only the client library.
License in practice
Permissive BSD-style license (with portions under MIT from the 'six' project) allows commercial and private use with attribution; no copyleft restrictions.
Quickstart
pip install pywatchman
import pywatchman
client = pywatchman.client()
result = client.query('watch-project', '/path/to/watch')Verify before relying
- Whether Watchman daemon must be installed separately on the system for pywatchman to function
- Supported platforms beyond the macOS arm64 wheels shown in friction evidence
- Whether this is a pure Python client or requires compiled components on other platforms
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 63 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 493,246 / month, #6,356 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: System :: Filesystems |
Evidence: pywatchman-4.0.0-cp310-cp310-macosx_11_0_arm64.whl; pywatchman-4.0.0-cp311-cp311-macosx_11_0_arm64.whl; pywatchman-4.0.0-cp312-cp312-macosx_11_0_arm64.whl; pywatchman-4.0.0-cp313-cp313-macosx_11_0_arm64.whl; pywatchman-4.0.0-cp314-cp314-macosx_11_0_arm64.whl; pywatchman-4.0.0-cp38-cp38-macosx_11_0_arm64.whl; pywatchman-4.0.0-cp39-cp39-macosx_11_0_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 › “watchman python client”
- pywatchmanpywatchman is a Python client for Watchman, a file watching service…
- django-watchmandjango-watchman exposes a status endpoint that reports the health of…
- django-watchfilesReplaces Django's default file-change watcher with watchfiles, a…
Give your agent the search over MCP, or paste the wish link into any chat.
More Filesystems packages
Watches file system changes and triggers callbacks or process restarts when files are modified, with both synchronous and asynchronous APIs.
Install it if you need file system monitoring for development or production workflows.
Watchdog monitors file system events across Linux, macOS, Windows, and BSD, providing a Python API and command-line utilities to detect file and directory changes in real time.
Install it if you need to monitor file system events; the medium install friction is a one-time cost for reliable, platform-native behavior.
Portalocker provides cross-platform file locking with support for exclusive and shared locks, plus Redis-based distributed locks and process-aware PID file locking.
Install it if you need file or process coordination; the optional extras (pywin32, redis) are only required for specific lock types.
Infers file type and MIME type by examining magic number signatures in files or byte buffers, with no external dependencies.
However, the last release was 2022-11-02 with no recent commits, so it may not support the newest file formats or receive bug fixes promptly.
Sanitize and validate filenames and file paths by removing or replacing invalid characters, reserved names, and unprintable characters across multiple platforms (Linux, Windows, macOS, POSIX, and universal).
Install it if you need reliable filename or path validation across platforms; the low friction and clear API make it a straightforward addition to any project…
Provides object-oriented filesystem path handling as a backport for Python versions before 3.4, when pathlib became part of the standard library.
See also django-watchfiles · pyinotify · watchgod · django-watchman · asyncinotify · pyobjc-framework-FSEvents · inotify · inotify-simple