UV - Python Package Manager Extension

A powerful VS Code extension for UV — the extremely fast Python package manager.

Features at a glance: Project templates • Dependency management • Python version switching • Virtual environments • HTTP server • Testing • And more!

📋 Changelog

v1.1.0 (2026-01-23)

Added:

• New setting uv.statusBar.showHttpServer to show/hide the HTTP server status bar item (default: true)
• Real-time configuration change detection — toggling the setting applies immediately without restart

v1.0.0 (2025-12-20) 🎉

First stable release! A comprehensive VS Code extension for UV, the extremely fast Python package manager.

✨ Core Features:

• Project Wizard — 15 templates across 7 categories (Web API, CLI, Data Science, AI/ML, Automation, Desktop GUI)
• Dependency Management — Add, remove, update packages with PyPI integration and auto-sync
• Python Version Management — Install, list, and switch Python versions with automatic venv recreation
• Virtual Environments — Create, activate, and manage venvs with terminal integration
• Run with UV — Execute Python files from Play button, context menu, or command palette
• Testing — Run pytest/unittest with coverage reports
• HTTP Server — Serve static files with browser integration
• Build & Publish — Build packages and publish to PyPI
• Status Bar — Project info, Python version, dependencies, venv status always visible

🖥️ UI Features:

• Sidebar tree views for dependencies, environments, and cache
• Right-click context menus for Python files
• Play button dropdown with "Run with UV" option
• Quick Actions menu for common operations

v0.4.1 (2025-12-20)

Fixed:

• Fixed .python-version writing full toolchain ID instead of version number when switching Python versions

v0.4.0 (2025-12-20)

Added:

• "Run with UV" option in the Play button dropdown menu for Python files

v0.3.2 (2025-12-20)

Fixed:

• Fixed UV not detected after installation until full VS Code restart
• Changed "Reload Window" to "Restart VS Code" after UV installation to properly refresh PATH

v0.3.1 (2025-12-20)

Fixed:

• Fixed project name sanitization for folders with spaces (e.g., "My Project" → "my-project")
• Fixed .python-version file format (now writes "3.14.2" instead of full ID)
• Fixed GUI templates (Tkinter, PyQt6) not being created correctly
• Fixed shell redirection issue when adding packages with version specifiers
• Fixed empty project template missing pyproject.toml
• Fixed progress notification staying stuck after project creation
• Fixed package install hanging indefinitely for invalid packages (added 60s timeout)
• Fixed category selection failing for multi-codepoint emojis (Desktop GUI)
• Fixed .vscodeignore excluding template .gitignore files

v0.3.0 (2025-12-18)

Added:

• Project Wizard: 15 project templates across 7 categories
  • Empty Project, Web API (FastAPI, Flask, Django), CLI (Typer, Click)
  • Data Science (Jupyter, Analysis), AI/ML (LangChain, PyTorch, Scikit-Learn)
  • Automation (Scrapy, Playwright), Desktop GUI (Tkinter, PyQt6)
• Dynamic Python version in templates (uses selected version)
• Post-install instructions for each template

Changed:

• Simplified dependency management UI (removed redundant prompts)
• Simplified package details page (View on PyPI only)
• Python version management no longer re-prompts after selection

Fixed:

• Fixed uv run errors with hatchling build system in templates
• Fixed recursive prompts in Python version management

v0.2.0 (2025-12-18)

Added:

• UV installation prompt on activation
• Python version selection during project initialization
• Real package details from PyPI API

Changed:

• Simplified project initialization with uv init
• Enhanced package details UI with VS Code theme colors

Fixed:

• Fixed bug where a "list" folder was incorrectly created

✨ Features

🚀 Project Wizard — Start Projects in Seconds

Create fully-configured Python projects with a 4-step wizard:

Each template includes working code, proper dependencies, and your selected Python version.

📦 Dependency Management — Full Package Control

Tree View: See all your dependencies in the sidebar explorer panel.

🐍 Python Version Management

🔧 Virtual Environments

• Create venv — Create .venv with your chosen Python version
• Activate/Deactivate — Manage venv state with one click
• Terminal Integration — Venv auto-activated in VS Code terminal
• Explorer View — See all environments in the sidebar

▶️ Run Python Files

• Run with UV — Available in the Play button dropdown
• Right-click Run — Run any .py file from context menu
• Interactive Run — Run custom commands with uv run

🧪 Testing

• Run Test File — Execute tests with pytest or unittest
• Run Test Method — Run individual test functions
• Manage Tests — Configure test settings
• Coverage Reports — Generate HTML, XML, or terminal coverage

🌐 HTTP Server

• Quick Start — Serve any folder as static files
• Browser Support — Open in Safari, Chrome, Firefox, Edge, or Brave
• Status Bar — Start/stop server from status bar

📦 Build & Publish

• Build Package — Build your package for distribution
• Publish — Publish to PyPI or other registries
• Export Lockfile — Export dependencies to requirements format

📊 Status Bar Integration

Always-visible information at a glance:

🔧 Additional Commands

| Command | Description | |---------|-------------| | UV: Sync Environment | Sync dependencies with lockfile | | UV: Update Lockfile | Update uv.lock file | | UV: Manage Cache | View and clean UV cache | | UV: Pip Interface | Access pip-compatible commands | | UV: Run Tools | Run Python tools (uvx) | | UV: Self Management | Update UV itself | | UV: Show Help | View UV documentation |

📖 Quick Start

1. Install UV (if needed)

The extension will prompt you to install UV if not found. Or install manually:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Create a New Project

1. Open Command Palette: Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows/Linux)
2. Run UV: Initialize Project
3. Select a category and template
4. Enter project name
5. Choose Python version
6. Start coding!

3. Keyboard Shortcuts

📋 All Commands

🔧 Requirements

• VS Code 1.85.0 or higher
• UV (will prompt to install if not found)

🛠️ Development

git clone https://github.com/mourad-ghafiri/uv-vscode-extension.git
cd uv-vscode-extension
npm install
npm run compile
# Press F5 to launch Extension Development Host

📄 License

MIT License — see LICENSE for details.

🔗 Links

• 📦 VS Code Marketplace
• 🐙 GitHub Repository
• 🐛 Report Issues
• 📚 UV Documentation
• ⚡ UV Project

Made with ❤️ for the Python community
_{by Mourad GHAFIRI}