uv Quickstart

One-click Python project scaffolding powered by uv.

Features

• Creates a fully configured Python project in seconds
• Initializes with uv init and uv venv
• Lets you pick from installed Python versions
• Generates boilerplate: src/main.py, .gitignore, .vscode/settings.json
• Auto-configures the VS Code Python interpreter for the virtual environment
• Installs uv for you if it's not already on your system
• Available as both a VS Code extension and a CLI tool

Usage

Option 1: VS Code / Kiro (GUI)

1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
2. Run uv: Create New Python Project.
3. Enter a project name.
4. Pick a Python version (or choose Default).
5. Select the parent directory.
6. Done — the new project opens in a fresh window, ready to go.

Option 2: CLI

Run it directly without installing:

npx uv-quickstart

Or install globally for repeated use:

npm install -g uv-quickstart
uv-quickstart

The CLI walks you through the same steps interactively:

uv Quickstart — Create a new Python project

Project name: my-app
Parent directory (default: /home/user):
Available Python versions:
  0) Default (system)
  1) cpython-3.12.3-linux-x86_64
  2) cpython-3.11.8-linux-x86_64
Select Python version [0]: 1

Creating project in /home/user/my-app...
✓ Project created successfully!

  cd /home/user/my-app
  source .venv/bin/activate
  python src/main.py

Generated Project Structure

my-python-project/
├── .gitignore
├── .venv/
├── .vscode/
│   └── settings.json
├── pyproject.toml
└── src/
    └── main.py

Requirements

• Node.js 18+ (for the CLI)