{"id":28809763,"url":"https://github.com/actepukc/uv-app-starter-pack","last_synced_at":"2026-04-30T20:32:38.945Z","repository":{"id":296229457,"uuid":"961517783","full_name":"AcTePuKc/uv-app-starter-pack","owner":"AcTePuKc","description":"Bootstrap PySide6 GUI apps quickly using uv, with built-in PyTorch/CUDA handling.","archived":false,"fork":false,"pushed_at":"2025-05-29T15:21:41.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-18T13:06:28.547Z","etag":null,"topics":["astral-uv","cross-platform","cuda","gui","pyside6","python","pytorch","qt6","starter-kit","template"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AcTePuKc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-06T17:23:51.000Z","updated_at":"2025-05-29T15:21:44.000Z","dependencies_parsed_at":"2025-05-29T17:06:32.235Z","dependency_job_id":null,"html_url":"https://github.com/AcTePuKc/uv-app-starter-pack","commit_stats":null,"previous_names":["actepukc/uv-app-starter-pack"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AcTePuKc/uv-app-starter-pack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcTePuKc%2Fuv-app-starter-pack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcTePuKc%2Fuv-app-starter-pack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcTePuKc%2Fuv-app-starter-pack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcTePuKc%2Fuv-app-starter-pack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AcTePuKc","download_url":"https://codeload.github.com/AcTePuKc/uv-app-starter-pack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcTePuKc%2Fuv-app-starter-pack/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260558854,"owners_count":23027722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astral-uv","cross-platform","cuda","gui","pyside6","python","pytorch","qt6","starter-kit","template"],"created_at":"2025-06-18T13:03:48.453Z","updated_at":"2026-04-30T20:32:38.932Z","avatar_url":"https://github.com/AcTePuKc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 📦 UV-App-Starter-Pack\n\nA clean, cross-platform Python GUI app bootstrapper using **PySide6** and **uv**. This starter pack helps you set up apps that require flexible environment handling (like Torch/CUDA), with minimal effort.\n\n---\n## Prerequisites\n\n*   **Python:** A compatible version (defaults to `3.11` in launchers, but can be changed). Ensure it's in your system's PATH.\n*   **uv:** The Python package manager. Install it if you haven't already:\n    ```bash\n    pip install uv\n    # or pipx install uv\n    ```\n    See the [official uv documentation](https://github.com/astral-sh/uv#installation) for more ways to install.\n\n## 🧰 Features\n\n- Python `3.11` virtual environment with `uv`\n- Optional PyTorch installation (auto-matches CUDA version)\n- Supports `--dry` or `UV_APP_DRY=1` to skip PyTorch install (good for testing)\n- Cross-platform launchers: `.bat`, `.ps1`, `.sh`\n- Clean GUI stub using `PySide6` (can be replaced with your own GUI)\n- Friendly for beginners and pro devs alike\n\n---\n\n### 🛠 Folder Contents\n\n| File                  | Purpose |\n|-----------------------|---------|\n| `main.py`             | Launches your GUI app |\n| `gui/gui_app.py`      | PySide6 GUI logic (`UVAppWindow`) |\n| `gui/__init__.py`     | Makes `gui` a Python package |\n| `install_torch.py`  | Smart PyTorch installer (CUDA-aware) |\n| `requirements.txt`    | Base dependencies (synced by `uv`) |\n| `run_uv.bat`          | Windows launcher |\n| `run_uv.ps1`          | PowerShell launcher |\n| `run_uv.sh`           | Linux/macOS/WSL launcher |\n\n---\n\n### 🚀 Quickstart\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🪟 Windows (run_uv.bat)\u003c/strong\u003e\u003c/summary\u003e\n\n```bat\n:: Optional: Skip torch install (for testing)\nset UV_APP_DRY=1\n\n:: Run this script\nrun_uv.bat\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e💻 PowerShell (run_uv.ps1)\u003c/strong\u003e\u003c/summary\u003e\n\n```powershell\n$env:UV_APP_DRY=1   # Optional\n./run_uv.ps1\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🐧 Linux/macOS (run_uv.sh)\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nexport UV_APP_DRY=1   # Optional\nchmod +x run_uv.sh\n./run_uv.sh\n```\n\n\u003c/details\u003e\n\n---\n\n### ⚙️ Environment Behavior\n\n| Variable / Flag     | Effect |\n|---------------------|--------|\n| `UV_APP_DRY=1`      | Skips PyTorch installation |\n| `--dry`             | Same effect when passed directly to `install_pytorch.py` |\n| Python version      | Controlled inside the launcher (`python3.11` by default) |\n\n---\n\n### 🧪 Testing (No CUDA/No Torch)\n\nIf you're just testing the GUI, set `UV_APP_DRY=1` in your script or terminal. This skips the heavy install step.\n\n---\n\n### 🧠 Ideas for Expansion\n\n- Add translation files or multi-language GUI switching\n- Drop in custom GUI logic (e.g. Whisper, TTS, transcription)\n- Add `.env` support for dynamic configuration\n\n---\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eAbout UV-App-Starter-Pack\u003c/strong\u003e\u003c/summary\u003e\n\nThis project was created to simplify the often tedious process of setting up a new Python GUI application, especially when targeting multiple operating systems (Windows, macOS, Linux) and dealing with dependencies that require specific system configurations (like PyTorch with different CUDA versions).\n\n**Core Goals:**\n\n*   **Rapid Setup:** Use `uv` for near-instantaneous virtual environment creation and dependency installation.\n*   **Cross-Platform:** Provide ready-to-use launcher scripts (`.bat`, `.ps1`, `.sh`) for a consistent experience everywhere.\n*   **Dependency Handling:** Demonstrate robust dependency management, including the conditional installation of PyTorch based on detected CUDA capabilities.\n*   **Clean Foundation:** Offer a minimal PySide6 GUI application stub that is easy to replace or build upon.\n\nWhether you're a beginner looking for an easy entry into GUI development or an experienced developer needing a reliable template for ML/AI or other complex applications, this starter pack aims to get you running faster.\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factepukc%2Fuv-app-starter-pack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factepukc%2Fuv-app-starter-pack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factepukc%2Fuv-app-starter-pack/lists"}