watchfiles 1.1.1


pip install watchfiles

  Latest version

Released: Oct 14, 2025
Navigation
Meta
Author: Samuel Colvin
Requires Python: >=3.9
Classifiers

Development Status
  • 5 - Production/Stable

Environment
  • MacOS X

Programming Language
  • Python
  • Python :: 3
  • Python :: 3 :: Only
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14

Intended Audience
  • Developers
  • Information Technology
  • System Administrators

License
  • OSI Approved :: MIT License

Operating System
  • POSIX :: Linux
  • Microsoft :: Windows
  • MacOS

Topic
  • Software Development :: Libraries :: Python Modules
  • System :: Filesystems

Framework
  • AnyIO

watchfiles

CI Coverage pypi CondaForge license

Simple, modern and high performance file watching and code reload in python.

Documentation: watchfiles.helpmanual.io

Source Code: github.com/samuelcolvin/watchfiles

Underlying file system notifications are handled by the Notify rust library.

This package was previously named "watchgod", see the migration guide for more information.

Installation

watchfiles requires Python 3.9 - 3.14.

pip install watchfiles

Binaries are available for most architectures on Linux, MacOS and Windows (learn more).

Otherwise, you can install from source which requires Rust stable to be installed.

Usage

Here are some examples of what watchfiles can do:

watch Usage

from watchfiles import watch

for changes in watch('./path/to/dir'):
    print(changes)

See watch docs for more details.

awatch Usage

import asyncio
from watchfiles import awatch

async def main():
    async for changes in awatch('/path/to/dir'):
        print(changes)

asyncio.run(main())

See awatch docs for more details.

run_process Usage

from watchfiles import run_process

def foobar(a, b, c):
    ...

if __name__ == '__main__':
    run_process('./path/to/dir', target=foobar, args=(1, 2, 3))

See run_process docs for more details.

arun_process Usage

import asyncio
from watchfiles import arun_process

def foobar(a, b, c):
    ...

async def main():
    await arun_process('./path/to/dir', target=foobar, args=(1, 2, 3))

if __name__ == '__main__':
    asyncio.run(main())

See arun_process docs for more details.

CLI

watchfiles also comes with a CLI for running and reloading code. To run some command when files in src change:

watchfiles "some command" src

For more information, see the CLI docs.

Or run

watchfiles --help
1.1.1 Oct 14, 2025
1.1.0 Jun 15, 2025
1.0.5 Apr 08, 2025
1.0.4 Jan 10, 2025
1.0.3 Dec 10, 2024
1.0.2 Dec 10, 2024
1.0.1 Dec 10, 2024
1.0.0 Nov 25, 2024
0.24.0 Aug 28, 2024
0.23.0 Aug 07, 2024
0.22.0 May 27, 2024
0.21.0 Oct 13, 2023
0.20.0 Aug 24, 2023
0.19.0 Mar 27, 2023
0.18.1 Nov 07, 2022
0.18.0 Oct 19, 2022
0.17.0 Sep 11, 2022
0.16.1 Jul 25, 2022
0.16.0 Jul 21, 2022
0.15.0 Jun 17, 2022
0.15.0a1 Jun 03, 2022
0.14.1 May 17, 2022
0.14 May 16, 2022
0.13 Apr 09, 2022
0.12 Apr 01, 2022
0.11 Mar 30, 2022
0.10 Mar 23, 2022
0.0.0a1 Mar 15, 2022

Wheel compatibility matrix

Platform CPython 3.9 CPython 3.10 CPython 3.11 CPython 3.12 CPython 3.13 CPython 3.14 CPython (additional flags: t) 3.13 CPython (additional flags: t) 3.14 PyPy 3.9 (pp73) PyPy 3.10 (pp73) PyPy 3.11 (pp73)
macosx_10_12_x86_64
macosx_11_0_arm64
manylinux2014_aarch64
manylinux2014_armv7l
manylinux2014_i686
manylinux2014_ppc64le
manylinux2014_s390x
manylinux2014_x86_64
manylinux_2_17_aarch64
manylinux_2_17_armv7l
manylinux_2_17_i686
manylinux_2_17_ppc64le
manylinux_2_17_s390x
manylinux_2_17_x86_64
musllinux_1_1_aarch64
musllinux_1_1_x86_64
win32
win_amd64
win_arm64

Files in release

watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl (397.8KiB)
watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl (385.2KiB)
watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (439.3KiB)
watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (448.3KiB)
watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl (476.9KiB)
watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (581.9KiB)
watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl (462.4KiB)
watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (444.9KiB)
watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl (615.9KiB)
watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl (607.9KiB)
watchfiles-1.1.1-cp310-cp310-win32.whl (266.3KiB)
watchfiles-1.1.1-cp310-cp310-win_amd64.whl (280.7KiB)
watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl (397.0KiB)
watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl (385.1KiB)
watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (438.3KiB)
watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (449.7KiB)
watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl (477.3KiB)
watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (582.1KiB)
watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl (461.8KiB)
watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (445.4KiB)
watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl (614.7KiB)
watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl (608.4KiB)
watchfiles-1.1.1-cp311-cp311-win32.whl (265.1KiB)
watchfiles-1.1.1-cp311-cp311-win_amd64.whl (280.9KiB)
watchfiles-1.1.1-cp311-cp311-win_arm64.whl (270.7KiB)
watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl (395.3KiB)
watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl (382.6KiB)
watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (438.8KiB)
watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (448.7KiB)
watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl (477.4KiB)
watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (580.9KiB)
watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl (464.0KiB)
watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (446.1KiB)
watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl (615.4KiB)
watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl (608.1KiB)
watchfiles-1.1.1-cp312-cp312-win32.whl (265.7KiB)
watchfiles-1.1.1-cp312-cp312-win_amd64.whl (281.7KiB)
watchfiles-1.1.1-cp312-cp312-win_arm64.whl (271.7KiB)
watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl (394.8KiB)
watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl (382.6KiB)
watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (438.7KiB)
watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (448.6KiB)
watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl (477.5KiB)
watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (581.5KiB)
watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl (463.8KiB)
watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (445.5KiB)
watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl (615.2KiB)
watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl (607.7KiB)
watchfiles-1.1.1-cp313-cp313-win32.whl (265.7KiB)
watchfiles-1.1.1-cp313-cp313-win_amd64.whl (281.4KiB)
watchfiles-1.1.1-cp313-cp313-win_arm64.whl (271.4KiB)
watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl (393.9KiB)
watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl (380.8KiB)
watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (437.6KiB)
watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (449.5KiB)
watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl (476.4KiB)
watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (581.2KiB)
watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl (462.5KiB)
watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (444.8KiB)
watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl (614.1KiB)
watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl (607.6KiB)
watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl (394.8KiB)
watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl (381.7KiB)
watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (439.4KiB)
watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (450.0KiB)
watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl (477.6KiB)
watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (581.7KiB)
watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl (463.7KiB)
watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (444.4KiB)
watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl (615.8KiB)
watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl (607.9KiB)
watchfiles-1.1.1-cp314-cp314-win32.whl (265.7KiB)
watchfiles-1.1.1-cp314-cp314-win_amd64.whl (280.9KiB)
watchfiles-1.1.1-cp314-cp314-win_arm64.whl (270.7KiB)
watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl (394.4KiB)
watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl (381.4KiB)
watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (437.9KiB)
watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (448.2KiB)
watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl (476.7KiB)
watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (582.1KiB)
watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl (462.7KiB)
watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (444.4KiB)
watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl (614.4KiB)
watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl (607.5KiB)
watchfiles-1.1.1-cp39-cp39-macosx_10_12_x86_64.whl (399.6KiB)
watchfiles-1.1.1-cp39-cp39-macosx_11_0_arm64.whl (387.4KiB)
watchfiles-1.1.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (440.9KiB)
watchfiles-1.1.1-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (450.0KiB)
watchfiles-1.1.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl (479.1KiB)
watchfiles-1.1.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (583.7KiB)
watchfiles-1.1.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl (463.8KiB)
watchfiles-1.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (446.8KiB)
watchfiles-1.1.1-cp39-cp39-musllinux_1_1_aarch64.whl (617.4KiB)
watchfiles-1.1.1-cp39-cp39-musllinux_1_1_x86_64.whl (609.3KiB)
watchfiles-1.1.1-cp39-cp39-win32.whl (267.6KiB)
watchfiles-1.1.1-cp39-cp39-win_amd64.whl (282.3KiB)
watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl (400.0KiB)
watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl (387.6KiB)
watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (441.0KiB)
watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (447.7KiB)
watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl (398.7KiB)
watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl (386.8KiB)
watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (439.9KiB)
watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (446.8KiB)
watchfiles-1.1.1-pp39-pypy39_pp73-macosx_10_12_x86_64.whl (399.6KiB)
watchfiles-1.1.1-pp39-pypy39_pp73-macosx_11_0_arm64.whl (388.0KiB)
watchfiles-1.1.1-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (441.2KiB)
watchfiles-1.1.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (447.8KiB)
watchfiles-1.1.1.tar.gz (92.2KiB)
Extras: None
Dependencies:
anyio (>=3.0.0)