What happened
On a clean Windows 11 machine, lk app create --template agent-starter-python <name> fails to install dependencies:
⚠ Installation failed — dependencies were NOT installed
┃ "uv": executable file not found in $PATH
┃ Fix your toolchain, then re-run the install step manually in ./speed-to-lead.
The command then proceeds to tell the user to run:
cd speed-to-lead
uv sync
uv run src\agent.py dev
uv is the only documented way to run the generated project, but the CLI:
- never checks whether
uv is installed before relying on it,
- doesn't offer to install it, and
- tells the user to "fix your toolchain" without naming what the toolchain is, what
uv is, or where to get it.
Why it matters
A developer who has never used uv has to stop, search, and work out that they need to winget install --id=astral-sh.uv -e (and then restart their shell, since it modifies PATH). That's a hard stop roughly four minutes into a first-run experience that is otherwise excellent.
The rest of the onboarding is unusually good — the starter agent runs with zero model API keys, which is a genuinely hard problem to have solved. This one missing preflight check is out of step with the rest of it.
Environment
- Windows 11
- LiveKit CLI 2.17.0 (
winget install LiveKit.LiveKitCLI)
- PowerShell
- Template:
agent-starter-python
Steps to reproduce
- On a machine without
uv installed
winget install LiveKit.LiveKitCLI
- Restart shell
lk cloud auth
lk app create --template agent-starter-python <name>
- Observe the install failure
Suggested fix
Any one of these would close it:
- Preflight check for
uv before template install, with a clear message naming it and linking to https://docs.astral.sh/uv/
- Offer to install it (
winget / brew / curl depending on platform)
- At minimum, change "Fix your toolchain" to "
uv is required — install it from https://docs.astral.sh/uv/ and re-run"
What happened
On a clean Windows 11 machine,
lk app create --template agent-starter-python <name>fails to install dependencies:The command then proceeds to tell the user to run:
uvis the only documented way to run the generated project, but the CLI:uvis installed before relying on it,uvis, or where to get it.Why it matters
A developer who has never used
uvhas to stop, search, and work out that they need towinget install --id=astral-sh.uv -e(and then restart their shell, since it modifies PATH). That's a hard stop roughly four minutes into a first-run experience that is otherwise excellent.The rest of the onboarding is unusually good — the starter agent runs with zero model API keys, which is a genuinely hard problem to have solved. This one missing preflight check is out of step with the rest of it.
Environment
winget install LiveKit.LiveKitCLI)agent-starter-pythonSteps to reproduce
uvinstalledwinget install LiveKit.LiveKitCLIlk cloud authlk app create --template agent-starter-python <name>Suggested fix
Any one of these would close it:
uvbefore template install, with a clear message naming it and linking to https://docs.astral.sh/uv/winget/brew/curldepending on platform)uvis required — install it from https://docs.astral.sh/uv/ and re-run"