📦 Python package manager
Keep your Mac awake while uv runs
uv resolves and installs dependencies in fast, CPU-heavy bursts. AwakeMate keeps your Mac awake while uv works and - if you like - lets it sleep the moment the install finishes.
Free 14-day trial · one-time $39.99 · no telemetry · macOS 13+
When your Mac sleeps mid-uv
A big uv sync or uv pip install can hammer the CPU resolving and downloading a large dependency tree. Walk away during a fresh environment build and macOS may decide the Mac is idle and sleep it mid-resolve, leaving a half-populated environment you have to rerun. For unattended installs on CI-style setups or bootstrap scripts, that's a silent failure.
AwakeMate keeps it awake while uv runs
AwakeMate watches for the uv process, so installs, resolves and uv run invocations are recognised by name. Because uv is its own binary rather than a script behind python, plain process matching is enough - add uv to your watched tools and every run is covered.
Detected process: uv
Tip: turn on "Sleep when tools go idle"
Turn "sleep when idle" ON for uv. Its work is bursty and CPU-bound - resolving and installing a dependency tree pegs the cores, then it's done - which is exactly the case idle-sleep is built for: stay awake while uv is actively working, then let the Mac sleep the instant the install finishes. If you instead run a long-lived process via uv run - a dev server, say - leave idle-sleep off so the waiting process isn't cut short.
Get the most out of it
- Keep idle-sleep on so a long
uv syncholds the Mac awake, then lets it rest the second the resolve completes. - Using
uv runto launch a long-lived server? Turn idle-sleep off for that, since the process waits rather than burning CPU.
More questions about uvtap to expand
Will my Mac sleep in the middle of a big uv install?
No. While uv is actively resolving or installing, AwakeMate keeps the Mac awake. With idle-sleep on, it then lets the Mac rest as soon as the install finishes, so nothing is cut short and nothing is held awake needlessly.
Why should idle-sleep be on for uv but off for a dev server?
uv is a CPU-bound burst - it works hard, then exits - so idle-sleep correctly sleeps the Mac when it's done. A dev server mostly waits, so idle would cut it off; for those, see Python and leave it off.
Does AwakeMate need any special permissions to see uv running?
No. It reads only short process names on-device, with no telemetry and no special access. Detecting uv needs nothing beyond the process name itself.
What's the best way to keep my Mac awake during a long uv install?
Add uv to AwakeMate's watched tools and it keeps the Mac awake while uv is resolving or installing, with nothing to start by hand. With idle-sleep on - the recommended setting for uv - it also lets the Mac sleep the moment the install finishes, so a fresh-environment bootstrap won't be cut short and the Mac won't be held awake afterwards.
Why not just run caffeinate before uv instead of installing an app?
You can run caffeinate uv sync - it uses the same IOKit assertion - but it's manual: you have to prefix every install, it keeps the whole Mac awake for the duration, and it has no idle-aware sleep or battery cutoff. AwakeMate detects uv automatically and, with idle-sleep on, releases the Mac as soon as the bursty CPU work is done.
My Mac sleeps mid-resolve on a big uv sync - how do I stop that?
That happens when macOS reads a pause in uv's work as inactivity and sleeps before the resolve completes. AwakeMate keeps the Mac awake while uv is actively working (lid open) so the dependency tree finishes installing. It never changes your saved Energy Saver settings - the assertion lifts on its own once uv exits.
Will it keep my Mac awake for uv with the lid closed, even on battery?
Yes. Turn on "Keep awake with the lid closed" in Settings - Options and approve the one-time helper; AwakeMate then keeps the Mac awake with the lid shut while uv runs, and dims the built-in screen so it is not draining the battery under the lid. It works on most Apple Silicon Macs (Apple forces sleep on some, so close your lid once to confirm). It works on battery too, but real work drains it faster, so keep it on power for long runs. See how it works.