From 3cf75aeb47c319489072c5934e42d58abb1dc5cb Mon Sep 17 00:00:00 2001 From: CodeBySayak Date: Thu, 2 Apr 2026 13:44:40 +0530 Subject: [PATCH 1/5] Update install instructions to use pipx instead of pip3 --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ef5e786c0..20c82240a 100644 --- a/README.md +++ b/README.md @@ -14,9 +14,12 @@ Visit the [Wiki](../../wiki) for more information. Install via PyPI: ```bash -pip3 install linode-cli +pipx install linode-cli ``` - +To upgrade: +``` +pipx upgrade linode-cli +We recommend using `pipx` to install `linode-cli`, as it installs Python CLI tools in isolated environments and avoids conflicts with system-managed Python packages (PEP 668). Visit the [Wiki](../../wiki/Installation) for more information. ## Contributing From 22faae2a6608c9007e763c25f31f1a4beb6e0642 Mon Sep 17 00:00:00 2001 From: CodeBySayak Date: Fri, 3 Apr 2026 18:58:06 +0530 Subject: [PATCH 2/5] Update README.md Co-authored-by: Michal Wojcik <32574975+mgwoj@users.noreply.github.com> --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 20c82240a..e99a5ec27 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,7 @@ pipx install linode-cli To upgrade: ``` pipx upgrade linode-cli +``` We recommend using `pipx` to install `linode-cli`, as it installs Python CLI tools in isolated environments and avoids conflicts with system-managed Python packages (PEP 668). Visit the [Wiki](../../wiki/Installation) for more information. From 0c15dbcdb0672c63eb20b21595522405c50cd187 Mon Sep 17 00:00:00 2001 From: CodeBySayak Date: Sun, 5 Apr 2026 15:08:32 +0530 Subject: [PATCH 3/5] Update README.md Co-authored-by: Michal Wojcik <32574975+mgwoj@users.noreply.github.com> --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index e99a5ec27..73e2d9f36 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ To upgrade: ``` pipx upgrade linode-cli ``` +``` We recommend using `pipx` to install `linode-cli`, as it installs Python CLI tools in isolated environments and avoids conflicts with system-managed Python packages (PEP 668). Visit the [Wiki](../../wiki/Installation) for more information. From 539ce2f2b000e8f976c3c052a36327c3670bcddd Mon Sep 17 00:00:00 2001 From: Zhiwei Liang <121905282+zliang-akamai@users.noreply.github.com> Date: Thu, 7 May 2026 13:09:55 -0400 Subject: [PATCH 4/5] Apply suggestion from @mgwoj Co-authored-by: Michal Wojcik <32574975+mgwoj@users.noreply.github.com> --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 73e2d9f36..e99a5ec27 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,6 @@ To upgrade: ``` pipx upgrade linode-cli ``` -``` We recommend using `pipx` to install `linode-cli`, as it installs Python CLI tools in isolated environments and avoids conflicts with system-managed Python packages (PEP 668). Visit the [Wiki](../../wiki/Installation) for more information. From 62d0cd48ee56512b83b9a4920ab1ea457d355adf Mon Sep 17 00:00:00 2001 From: Zhiwei Liang <121905282+zliang-akamai@users.noreply.github.com> Date: Fri, 14 Aug 2026 18:07:52 -0400 Subject: [PATCH 5/5] Revise linode-cli installation instructions Updated installation instructions for linode-cli to recommend using pipx for better isolation and compatibility. --- README.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index e99a5ec27..afc8baf56 100644 --- a/README.md +++ b/README.md @@ -12,16 +12,21 @@ Visit the [Wiki](../../wiki) for more information. ## Install -Install via PyPI: +We recommend installing `linode-cli` with `pipx`, which installs each Python CLI tool into its own isolated environment and works on distributions where `pip install` fails because the system Python is marked as externally managed ([PEP 668](https://peps.python.org/pep-0668/)). If pipx isn't installed yet, follow the [pipx installation guide](https://pipx.pypa.io/latest/how-to/install-pipx.html). + +To install: + ```bash pipx install linode-cli ``` + To upgrade: -``` + +```bash pipx upgrade linode-cli ``` -We recommend using `pipx` to install `linode-cli`, as it installs Python CLI tools in isolated environments and avoids conflicts with system-managed Python packages (PEP 668). -Visit the [Wiki](../../wiki/Installation) for more information. + +The [Wiki](https://github.com/linode/linode-cli/wiki/Installation) covers other installation methods, including the Docker image, the GitHub Action, and building from source. ## Contributing