Using uvx with Local Development¶

See also: Building Voice Mode for creating development builds and wheels.

Running the local package with uvx¶

1. Direct local execution (simplest!)¶

# Run from the project directory - uvx automatically detects the command
uvx .

2. Using --from with local path (explicit command)¶

# Run from the project directory
uvx --from . voicemode

# Or from anywhere with full path
uvx --from /home/m/Code/github.com/mbailey/voicemode voicemode

2. Using file:// URL¶

uvx --from file:///home/m/Code/github.com/mbailey/voicemode voicemode

3. Installing in editable mode for development¶

# Install the package in editable mode
uv pip install -e .

# Then run directly (not through uvx)
voicemode

4. Building and installing locally¶

# Build the package
uv build

# Install from the built wheel
uvx --from dist/voice_mode-*.whl voicemode

Testing both package variants locally¶

# Test voice-mode package (default)
uvx --from . voicemode

# Test voice-mode package (legacy)
UV_PROJECT_FILE=pyproject-voice-mode.toml uvx --from . voice-mode

Common use cases¶

Quick test of local changes¶

uvx --from . voicemode --help

Test with additional dependencies¶

uvx --from . --with rich voicemode

Force reinstall (useful after code changes)¶

uvx --refresh --from . voicemode