⚡ nosleep-py

A zero-overhead, native Windows sleep and screen-lock prevention library and CLI tool.

No fake mouse movement. No CPU usage. Zero dependencies. Directly leverages Windows Kernel execution state flags (SetThreadExecutionState).

📦 Installation

pip install nosleep-py

Or with uv:

uv add nosleep-py

🚀 Python Library Usage

1. Context Manager (Recommended)

Automatically protects a block of code from system sleep, and safely restores normal behavior when finished (even if an exception occurs):

import time
from nosleep_py import keep_awake

# Keep system and screen awake during training/rendering
with keep_awake():
    print("Doing 2-hour heavy processing...")
    time.sleep(7200)

# Back to normal automatically!

2. Manual Controls

import nosleep_py

# Turn ON sleep prevention
nosleep_py.prevent_sleep(keep_display=True)

# ... Do your long-running tasks ...

# Turn OFF sleep prevention
nosleep_py.allow_sleep()

3. CPU Awake Only (Allow Screen/Display to Turn Off)

with keep_awake(keep_display=False):
    # Perfect for background downloads or overnight batch processing
    download_large_dataset()

💻 CLI Terminal Usage

Once installed, you can run nosleep directly from any terminal:

# Keep awake indefinitely (Press Ctrl+C to stop)
nosleep

# Keep awake for 30 minutes, then auto-stop
nosleep --minutes 30

# Keep CPU awake only (allow monitor to turn off)
nosleep --minutes 60 --no-display

🛡️ License

MIT License. Free for personal and commercial use.