Powered by uv · Tauri 2 · Open source

Run Python projects
with one click

No more cd, activate venv, run python. Register a folder once and you're done — manage and launch all your projects from a single desktop app.

⬇ Download ★ View on GitHub

macOS (Apple Silicon · Intel) · Windows 10+ · Free

uvws app screenshot
# What you used to do every time
cd ~/projects/comfyui && source .venv/bin/activate && python main.py
lsof -i :8188 | grep LISTEN
kill -9 48213

# With uvws
✓ Click a project → it runs (auto-wrapped with uv run)
✓ Detects localhost:8188 → shows an "Open in browser" button
✓ Kill Port button → keeps going until the port is actually free
FEATURES

We removed the busywork you repeat every time

All the little annoyances that pile up when you run several Python projects locally — handled, one by one.

🖱️

One-click run

Register a folder, then it's a single click. Internally wrapped with uv run so it works without a venv — and creates one on first run if missing.

🖥️

Built-in terminal

Each project's stdout/stderr streams live. When a localhost address shows up in the logs, an "Open in browser" button appears automatically.

⚡

Force-kill ports

Kills the process holding a port with SIGKILL and confirms it's actually freed. No more typing lsof when you hit "port already in use".

🧩

Import wizard

Importing a folder with requirements.txt or pyproject.toml? Pick a Python version (3.10–3.13) and install dependencies in one go.

🔀

Concurrent runs & auto-cleanup

Run multiple project servers at once, each with its own terminal and port. Quitting the app cleans up running servers — and orphans are swept on the next launch.

🌿

Git integration

If the project is a Git repo, see branch · ahead/behind · changed files · recent commits at a glance, and Fetch / Pull / Push with a button.

DOWNLOAD

Grab it and get going

Click a button and the latest version downloads directly — no detour through GitHub.

📋 What's new latest →
macOS · Apple Silicon
M1 ~ M4 · aarch64.dmg
Download →
macOS · Intel
x64.dmg
Download →
Windows 10+
x64-setup.exe
Download →

⚠️ You need uv installed first

macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh Windows (PowerShell) powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" If macOS shows a security warning on first launch (not yet notarized) xattr -cr /Applications/uvws.app
USE CASES

Great for these jobs

If you spin up local Python servers a lot, almost all of these apply.

Run ComfyUI Stable Diffusion WebUI Flask · FastAPI dev servers Streamlit · Gradio demos Django locally Jupyter · data scripts Discord bots · crawlers Run many Python projects at once Kill port (force-free) Auto-managed uv virtualenvs
FAQ

Frequently asked questions

A quick rundown of what uvws is and what Python tasks it's for.

What is uvws?
A Python project manager that lets you manage many local Python projects in one desktop app and run them with a single click. It wraps execution in Astral's uv run and adds a built-in terminal, force-kill ports, concurrent runs, and Git integration. Free and open source, for macOS and Windows.
What is uv? Do I have to install it?
uv is Astral's very fast Python package and virtualenv manager. uvws uses uv as its backend, so install it first: on macOS/Linux run curl -LsSf https://astral.sh/uv/install.sh | sh, on Windows run irm https://astral.sh/uv/install.ps1 | iex in PowerShell.
Can it launch local AI apps like ComfyUI or Stable Diffusion?
Yes. Register the folder of any Python-based local AI app — ComfyUI, Stable Diffusion WebUI, etc. — and launch it in one click. When a localhost address shows in the logs an "Open in browser" button appears, and a blocked port can be freed with Kill Port.
Does it work with Flask · FastAPI · Django · Streamlit?
Yes. It works with any Python project that runs a local dev server — Flask, FastAPI, Django, Streamlit, Gradio, and more. Each project runs concurrently with its own terminal and port.
What about "port already in use"?
Hit the Kill Port button: it SIGKILLs the process holding the port and confirms the port is actually freed — no more typing lsof or kill -9 yourself.
Do I have to create a venv myself?
No. uvws wraps runs in uv run, so it works without activating a venv and creates one on first run if missing. With a requirements.txt or pyproject.toml, the import wizard lets you pick a Python version (3.10–3.13) and install dependencies in one go.
Is it free? Which OSes are supported?
It's free and open source (MIT). It supports macOS (Apple Silicon · Intel) and Windows 10+, and you can grab the installer for your OS from the download buttons above.