Installation

There are multiple ways to install and run create-agentverse-agent. Choose the method that best fits your workflow.

⭐ Recommended: uvx (No Install)

The easiest way to use the tool — no installation required, similar to npx:

uvx create-agentverse-agent

This downloads and runs the latest version in an isolated environment. Perfect for one-off usage or trying out the tool.

Requirements: uv must be installed. Python 3.12+ for the CLI itself.

Run the CLI from a local checkout without publishing:

uvx --from /path/to/create-agentverse-agent create-agentverse-agent -d

Or install editable:

uv tool install --editable .
create-agentverse-agent --version

See CONTRIBUTING.md for make check and bundle sync.

Scaffolded agents are separate projects with their own toolchain:

Requirement	Why
Python 3.13	Locked in generated `pyproject.toml`
uv	Dependency management (`uv sync`)
Docker	Local Postgres via `docker compose` / `make db`

Install globally in an isolated environment:

pipx install create-agentverse-agent
create-agentverse-agent

Best for: Users who want the CLI always available without polluting their global Python environment.

Install directly with pip:

pip install create-agentverse-agent
create-agentverse-agent

Best for: Adding to existing projects or virtual environments.

Add as a dependency in a Poetry-managed project:

poetry add create-agentverse-agent
poetry run create-agentverse-agent

Note: Poetry installs the scaffolder CLI only. Generated agent projects use uv and hatch, not Poetry.

Check that the installation was successful:

create-agentverse-agent --version

You should see the current version number printed.

Once installed, head to Getting Started or the Usage Guide.