Skip to content

hirune924/uv-dash

Repository files navigation

UV Dash

UV Dash Logo

Python application launcher powered by uv

Test License: MIT

日本語 | Documentation


Overview

UV Dash makes it easy to run and manage Python applications without using the command line. From installation and launch to monitoring and secrets management, everything is handled through the GUI for uv-based Python apps and shell scripts.

uv-dash-demo.mp4

Why UV Dash?

  • Zero Command Line - Complete Python app management through an intuitive GUI
  • Universal Compatibility - Run anything uv run/uv x can execute (Python apps, shell scripts, custom commands). Major web frameworks (Streamlit, FastAPI, Flask, Gradio, Django, FastMCP) include automatic port detection
  • Production Ready - Built-in monitoring, logging, and secure secret management

Key Features

  • 🚀 Easy Installation - Install from GitHub, ZIP files, or local folders with drag & drop
  • One-Click Launch - Start and stop apps instantly with visual status indicators
  • 📊 Real-time Monitoring - Live CPU and memory usage graphs for each application
  • 📝 Integrated Logs - Color-coded log viewer for easy reading
  • 🔐 Secure Secrets - Encrypted storage for API keys and sensitive data
  • 🌐 Web App Support - Auto-detect ports from logs and provides quick launch button for web interfaces
  • 🌍 Multi-language - Full English and Japanese interface support

Screenshots

Apps View

Main application view

Logs View

Real-time log viewer

Install Modal

Install from GitHub/ZIP/Local

Settings

Secure secrets management

Quick Start

Installation

Download the latest version for your platform:

Platform Download
macOS (Apple Silicon) UV.Dash-arm64.dmg
macOS (Intel) UV.Dash-x64.dmg
Windows UV.Dash.Setup.exe
Linux UV.Dash.AppImage

Requirements: macOS 13+ / Windows 10+ / Ubuntu LTS

Note for macOS Apple Silicon users: You may encounter a certificate error when installing the ARM64 version. If this occurs, please use the Intel version (which runs via Rosetta 2) or run xattr -dr com.apple.quarantine "/Applications/UV Dash.app" in Terminal after installation to resolve the issue.

Usage

  1. Launch UV Dash - The app checks if uv is installed and offers one-click installation if needed
  2. Add Applications - Install from three sources:
    • GitHub: Clone repositories (with branch/tag support)
    • ZIP: Local or remote ZIP archives
    • Local Folder: Use existing projects on your machine
  3. Run & Monitor - Start apps with one click and monitor real-time CPU/memory usage
  4. View Logs & Access Web UIs - Watch live logs and click the 🌐 button to open web applications
  5. Manage Secrets - Configure environment variables and encrypted secrets per app

Advanced Features:

  • Configure Python version (defaults to 3.13)
  • Custom run commands for any executable
  • Multi-process application support

That's it! For detailed instructions, see the User Guide.

Documentation

Supported Python Frameworks

UV Dash automatically detects and supports:

  • Streamlit - Data applications and dashboards
  • FastAPI / Uvicorn - Modern web APIs
  • Flask - Traditional web applications
  • Gradio - Machine learning demos and interfaces
  • Django - Full-stack web framework
  • FastMCP - Model Context Protocol servers
  • Custom CLI apps - Any Python application with a run command

Tech Stack

  • Frontend: React 19 + TypeScript + Tailwind CSS 4
  • Desktop: Electron 38
  • Python: uv package manager
  • Security: Electron safeStorage API
  • i18n: i18next + react-i18next

License

MIT License - See LICENSE file for details.

Contributing

Contributions are welcome! Please see the Contributing Guide for details.

Support


Made with ❤️ by hirune924

About

Python application launcher powered by uv

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages