Pyreload documentation

Pyreload watches local files and restarts your Python application when they change. Use native filesystem events for local development, or polling for mounted folders.

Start here

pip install pyreload-cli
pyreload app.py

Install Pyreload, follow the quick start, or browse the CLI reference.

How it works

Diagram source

flowchart LR
    Save[Save a file] --> Watch[Native events or polling]
    Watch --> Filter{Matches watch patterns?}
    Filter -->|Yes, and not ignored| Restart[Stop and restart process]
    Filter -->|No| Wait[Keep watching]
    Restart --> Wait
    Wait --> Watch

Choose your workflow

• Watch patterns: select files and directories.
• Polling mode: watch Docker, Vagrant, or network mounts.
• Configuration: share project defaults.
• Troubleshooting: diagnose missed changes and restart loops.