> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentnet.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Install AgentNet CLI via pip, uvx, or from source code

> Install AgentNet CLI from PyPI with pip, run it without installing using uvx, or build from source — all methods require Python 3.11 or later.

AgentNet CLI is a Python package that installs the `agentnet` command on your system. It requires Python 3.11 or later and works on macOS, Linux, and Windows.

## Install methods

<CodeGroup>
  ```bash pip theme={null}
  pip install agentnet-cli
  ```

  ```bash uvx (no install) theme={null}
  uvx agentnet
  ```

  ```bash From source theme={null}
  git clone https://github.com/TheAgent-net/agentnet-cli.git
  cd agentnet-cli && uv sync
  ```
</CodeGroup>

### pip

Installing with `pip` adds `agentnet` to your PATH permanently. This is the recommended method for most users.

```bash theme={null}
pip install agentnet-cli
```

If you use a virtual environment, activate it first. To install system-wide on macOS or Linux, you may need to prefix with `sudo` or use `pip install --user agentnet-cli` to install into your user directory.

### uvx

`uvx` runs AgentNet CLI in a temporary, isolated environment without installing it persistently. This is useful if you want to try the CLI without modifying your Python environment, or if you use `uv` as your package manager.

```bash theme={null}
uvx agentnet
```

<Note>
  When running with `uvx`, replace `agentnet` in any command with `uvx agentnet`. For example: `uvx agentnet setup` or `uvx agentnet detect`. You do not need to run `pip install` first.
</Note>

### From source

If you want to run the latest unreleased code or contribute to the project:

```bash theme={null}
git clone https://github.com/TheAgent-net/agentnet-cli.git
cd agentnet-cli && uv sync
```

After syncing, run commands with `uv run agentnet`:

```bash theme={null}
uv run agentnet --help
```

## Verify the installation

After installing, confirm the CLI is available and check the version:

```bash theme={null}
agentnet --version
```

You should see output like:

```text theme={null}
agentnet 0.2.0
```

If the command is not found, check that your Python scripts directory is in your PATH. With `pip install --user`, the scripts directory is typically `~/.local/bin` on Linux/macOS or `%APPDATA%\Python\Scripts` on Windows.

## Python version requirement

AgentNet CLI requires Python 3.11 or later. It is tested against Python 3.11, 3.12, and 3.13.

To check your Python version:

```bash theme={null}
python --version
```

<Warning>
  Python 3.10 and earlier are not supported. If your system Python is older, use a tool like `pyenv` or install a newer Python version before installing AgentNet CLI.
</Warning>

## Upgrading

To upgrade to the latest version:

```bash theme={null}
pip install --upgrade agentnet-cli
```

Or let the CLI upgrade itself:

```bash theme={null}
agentnet update
```

`agentnet update` checks PyPI for a newer version, upgrades if one is available, and refreshes any stale agent connection configs.

## Next steps

Once installed, run `agentnet setup` to sign in and connect your agents:

```bash theme={null}
agentnet setup
```

See the [quickstart guide](/quickstart) for a step-by-step walkthrough of the setup flow.