uv 기반 · Tauri 2 · 오픈소스

파이썬 프로젝트를
클릭 한 번으로 실행

cd 하고 venv 켜고 python 돌리던 거, 이제 폴더 한 번 등록해두면 끝. 여러 프로젝트를 데스크탑 앱 하나에서 관리하고 실행하세요.

⬇ 다운로드 ★ GitHub에서 보기

macOS (Apple Silicon · Intel) · Windows 10+ · 무료

uvws app screenshot
# 원래 매번 이렇게 했죠
cd ~/projects/comfyui && source .venv/bin/activate && python main.py
lsof -i :8188 | grep LISTEN
kill -9 48213

# uvws에선
✓ 프로젝트 클릭 → 실행 (uv run으로 자동 래핑)
✓ localhost:8188 감지 → 브라우저 열기 버튼 자동 표시
✓ Kill Port 버튼 → 포트가 진짜 비워질 때까지 처리
FEATURES

매번 반복하던 잔손질을 없앴습니다

로컬에서 파이썬 프로젝트 여러 개 돌리다 보면 쌓이는 그 귀찮음들, 하나씩 정리했어요.

🖱️

원클릭 실행

폴더를 등록하면 그다음부턴 클릭 한 번. 내부적으로 uv run으로 감싸 venv 없이도 동작하고, 없으면 첫 실행 때 자동으로 만들어줍니다.

🖥️

내장 터미널

각 프로젝트의 stdout/stderr가 실시간으로 스트리밍. 로그에 localhost 주소가 뜨면 브라우저 열기 버튼이 알아서 나타납니다.

⚡

포트 강제 종료

포트를 잡고 있는 프로세스를 SIGKILL로 종료하고, 실제로 비워질 때까지 확인합니다. "포트가 이미 사용 중" 에러에 더는 lsof를 칠 필요가 없어요.

🧩

임포트 위저드

requirements.txt나 pyproject.toml이 있는 폴더를 가져올 때 Python 버전(3.10–3.13)을 고르고 의존성 설치까지 한 번에.

🔀

동시 실행 & 자동 정리

여러 프로젝트 서버를 동시에 띄우고 각각 독립된 터미널·포트로 관리. 앱을 끄면 돌던 서버가 함께 정리되고, 비정상 종료 시에도 다음 실행에서 청소합니다.

🌿

Git 통합

프로젝트가 Git 저장소면 브랜치·ahead/behind·변경 파일·최근 커밋을 한눈에 보고, Fetch / Pull / Push를 버튼으로 실행합니다.

DOWNLOAD

받아서 바로 써보세요

버튼을 누르면 최신 버전이 바로 다운로드됩니다. 깃허브 페이지를 거치지 않아요.

📋 업데이트 내용 보기 latest →
macOS · Apple Silicon
M1 ~ M4 · aarch64.dmg
바로 다운로드 →
macOS · Intel
x64.dmg
바로 다운로드 →
Windows 10+
x64-setup.exe
바로 다운로드 →

⚠️ 먼저 uv가 설치돼 있어야 합니다

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" macOS 첫 실행 시 보안 경고가 뜨면 (공증 전이라) xattr -cr /Applications/uvws.app
USE CASES

이런 작업에 잘 맞아요

로컬에서 파이썬 서버를 자주 띄우는 분이라면 거의 다 해당됩니다.

ComfyUI 실행 Stable Diffusion WebUI Flask · FastAPI 개발 서버 Streamlit · Gradio 데모 Django 로컬 실행 Jupyter · 데이터 분석 스크립트 디스코드 봇 · 크롤러 여러 파이썬 프로젝트 동시 실행 포트 강제 종료 (kill port) uv 가상환경 자동 관리
FAQ

자주 묻는 질문

uvws가 무엇이고 어떤 파이썬 작업에 쓰는지 빠르게 정리했습니다.

uvws는 어떤 앱인가요?
로컬 파이썬 프로젝트 여러 개를 데스크탑 앱 하나에서 관리하고 클릭 한 번으로 실행하는 파이썬 프로젝트 매니저입니다. 내부적으로 Astral의 uv run으로 감싸 실행하며, 내장 터미널·포트 강제 종료·여러 프로젝트 동시 실행·Git 통합을 제공합니다. macOS와 Windows를 지원하는 무료 오픈소스예요.
uv가 무엇인가요? 꼭 설치해야 하나요?
uv는 Astral이 만든 아주 빠른 파이썬 패키지·가상환경 관리 도구입니다. uvws는 uv를 백엔드로 쓰기 때문에 먼저 uv를 설치해야 합니다. macOS·Linux는 curl -LsSf https://astral.sh/uv/install.sh | sh, Windows는 PowerShell에서 irm https://astral.sh/uv/install.ps1 | iex 로 설치하세요.
ComfyUI, Stable Diffusion 같은 로컬 AI 앱도 실행되나요?
네. ComfyUI, Stable Diffusion WebUI 등 파이썬으로 도는 로컬 AI 앱을 폴더로 등록해두면 클릭 한 번으로 띄울 수 있습니다. 로그에 localhost 주소가 뜨면 '브라우저 열기' 버튼이 자동으로 나타나고, 포트가 막혀 있으면 Kill Port 버튼으로 비웁니다.
Flask · FastAPI · Django · Streamlit도 되나요?
됩니다. Flask, FastAPI, Django, Streamlit, Gradio 등 로컬 개발 서버를 띄우는 모든 파이썬 프로젝트에 쓸 수 있어요. 각 프로젝트는 독립된 터미널·포트로 동시에 실행·관리됩니다.
'포트가 이미 사용 중'일 때 어떻게 하나요?
Kill Port(포트 강제 종료) 버튼을 누르면 그 포트를 잡고 있는 프로세스를 SIGKILL로 종료하고, 포트가 실제로 비워질 때까지 확인합니다. lsof나 kill -9를 직접 칠 필요가 없어요.
venv(가상환경)를 직접 만들어야 하나요?
아니요. uvws가 uv run으로 감싸 실행하므로 venv 활성화 없이 동작하고, 가상환경이 없으면 첫 실행 때 자동으로 만들어 줍니다. requirements.txt나 pyproject.toml이 있으면 임포트 위저드에서 Python 버전(3.10–3.13)을 고르고 의존성까지 한 번에 설치합니다.
무료인가요? 어떤 OS를 지원하나요?
무료 오픈소스(MIT)입니다. macOS(Apple Silicon·Intel)와 Windows 10 이상을 지원하고, 위 다운로드 버튼에서 OS에 맞는 설치 파일을 바로 받을 수 있어요.