{"adoption": {"forks": 141, "observed_at": "2026-08-28T04:06:58.721962+00:00", "stars": 2529}, "canonical_url": "https://ross.abutalabs.com/products/watchfiles", "card": {"archived": false, "artifact_type": "library", "description": "Simple, modern and fast file watching and code reload for Python, written in Rust", "domain": ["developer-tools"], "enriched": true, "function": ["developer-tools", "cli", "concurrency"], "health_score": 97, "homepage": "https://watchfiles.helpmanual.io", "language": "Python", "license": "MIT", "license_family": "permissive", "maturity": "stable", "member_repos": ["samuelcolvin/watchfiles"], "name": "samuelcolvin/watchfiles", "platform": ["python", "windows", "cross-platform", "cli"], "pushed_at": "2026-08-09T06:45:58+00:00", "repo": "samuelcolvin/watchfiles", "stars": 2529, "tags": ["file-watching", "code-reload", "hot-reload", "rust", "asyncio", "inotify", "filesystem-notifications", "command-line", "automation", "linux", "macos"], "topics": ["python", "asyncio", "filesystem", "notify", "inotify", "inotifywatch", "uvicorn", "rust"], "urls": [], "use_cases": ["watch a directory for file changes in python", "auto-reload python code when files change", "run a command whenever files in a folder change", "async file watching with asyncio", "restart a dev server on file save", "monitor filesystem changes cross-platform"], "what_it_is": "watchfiles is a Python library providing simple, high-performance file watching and code reload, built on the Rust Notify library. It offers sync and async watch APIs, process restart utilities, and a CLI for running commands on file changes.", "when_to_avoid": ["you need file watching in a non-Python language", "you only need a one-time directory diff rather than live watching", "you cannot install binary wheels and lack a Rust toolchain"], "when_to_choose": ["you need fast, reliable file system notifications in Python", "you want automatic code reload during development", "you need both sync and asyncio watching APIs", "you want a batteries-included CLI for watch-and-run workflows"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/watchfiles", "repo": "samuelcolvin/watchfiles", "role": "main", "score": 88}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:06:58.721962+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T02:25:22.404658+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "07cba5bd7e29d50526a11825ff7f2eabfd7037b77d96c2d5b24f6420edb4ec0a", "fetched_at": "2026-08-28T04:06:58.721962+00:00", "kind": "readme", "missing": false, "url": "https://github.com/samuelcolvin/watchfiles"}, {"content_hash": "f1f5379966eb418ec04379c1d66b1db7d1467d328a37d57d6846e42317719256", "fetched_at": "2026-08-29T10:07:46.161522+00:00", "kind": "homepage", "missing": false, "url": "https://watchfiles.helpmanual.io"}, {"content_hash": "8b0ebb7c8a1f2f6cbc425ee0102512d69246891b3262ef0cccf7fe6d5fc6b470", "fetched_at": "2026-08-29T10:07:46.170533+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/watch"}, {"content_hash": "30f8a3582fcc919dff4a878967dcfa76eaba8a97772d984cbef17bdb75454767", "fetched_at": "2026-08-29T10:07:46.172724+00:00", "kind": "site_page", "missing": false, "url": "https://watchfiles.helpmanual.io/api/run_process"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 96, "longevity": 100, "rhythm": 72}, "computed_at": "2026-09-02T17:46:02.011165+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3246, "days_push": 24, "days_rel": 107, "gap_med": 49.0, "n_releases_24m": 9}, "score": 88, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}