Command-line installer

The agentville command does the Claude Code install for you: it adds the marketplace, installs one channel and adds the two steering lines to CLAUDE.md. It needs uv 0.13 or later and Python 3.15; uv downloads that Python when you do not have it.

Run it with uvx

uvx runs the latest published agentville without keeping it installed:

uvx agentville install
uvx agentville install --scope project
uvx agentville install --channel beta

If your uv is older than 0.13, run uv self update. Failing that, add --python 3.15 after uvx.

Install the agentville command

The install script puts a persistent agentville command on your PATH with uv tool install, for your user only. When uv is missing, it downloads Astral's official uv installer, pinned to one uv version, to a temporary file and runs it; it asks first only when you run it at a terminal. It never uses sudo or administrator rights, and running it again upgrades the command.

On Linux and macOS:

curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/minhphamdonhat/Agentville/main/install.sh | bash

On Windows, in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/minhphamdonhat/Agentville/main/install.ps1 | iex"

Then open a new terminal and run agentville install.

Options

The exit code is 0 on success, 1 when a step fails and 2 for a usage error. The README has the full details, including version pinning and environment variables.