Skip to content

Update README install instructions to use pipx#877

Open
CodeBySayak wants to merge 3 commits intolinode:devfrom
CodeBySayak:dev
Open

Update README install instructions to use pipx#877
CodeBySayak wants to merge 3 commits intolinode:devfrom
CodeBySayak:dev

Conversation

@CodeBySayak
Copy link
Copy Markdown

Summary

This PR updates the installation instructions in README.md to recommend pipx instead of pip3.

Changes

  • Replaced pip3 install linode-cli with pipx install linode-cli
  • Added pipx upgrade linode-cli command
  • Added explanation about why pipx is recommended (PEP 668)

Why

Using pipx avoids conflicts with system-managed Python environments and follows modern Python best practices.

How to Test

  • Follow updated install instructions using pipx
  • Verify CLI installs and runs correctly

@CodeBySayak CodeBySayak requested review from a team as code owners April 2, 2026 10:47
@CodeBySayak CodeBySayak requested review from mawilk90 and mgwoj and removed request for a team April 2, 2026 10:47
@mgwoj mgwoj requested a review from Copilot April 3, 2026 09:03
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the README installation guidance to recommend installing linode-cli via pipx instead of pip3, aligning with modern Python packaging practices (e.g., PEP 668 concerns around system-managed environments).

Changes:

  • Switched install command from pip3 install linode-cli to pipx install linode-cli.
  • Added an upgrade command (pipx upgrade linode-cli) and rationale for using pipx.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +19 to 23
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.
Copy link

Copilot AI Apr 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new "To upgrade" snippet opens a fenced code block but never closes it, which causes the recommendation text and the following "Visit the Wiki" line to render as code. Close the fence after the upgrade command, and consider using ```bash for consistency with the install snippet, with the explanatory sentence as a normal paragraph outside the code block.

Copilot uses AI. Check for mistakes.
Co-authored-by: Michal Wojcik <32574975+mgwoj@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants