Updating installation instructions

[Peter Hoyes]

Hi Kas developers,

I noticed recently that the Getting Started page [1] in the docs recommends installing Kas using sudo from the repository. This is becoming increasingly problematic with recent distros  (e.g. Ubuntu >=24.04) which forbid installing packages in "externally managed environments" [2].

Internally, we are currently recommending installing using pipx from PyPI, i.e.:

    pipx install kas --system-site-packages

, but other options are available of course (the "--system-site-packages" is required to pick up libnewt for the menu).

Would you accept a patch to update the Getting Started page along these lines?

Thanks,

Peter

[1] https://kas.readthedocs.io/en/latest/userguide/getting-started.html

[2] https://stackoverflow.com/questions/75608323/how-do-i-solve-error-externally-managed-environment-every-time-i-use-pip-3

IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you.

[Jan Kiszka]

On 27.11.25 14:34, Peter Hoyes wrote:
> Hi Kas developers,
>
> I noticed recently that the Getting Started page [1] in the docs
> recommends installing Kas using sudo from the repository. This is
> becoming increasingly problematic with recent distros  (e.g. Ubuntu
>>=24.04) which forbid installing packages in "externally managed
> environments" [2].
>
> Internally, we are currently recommending installing using pipx from
> PyPI, i.e.:
>
>     pipx install kas --system-site-packages
>
> , but other options are available of course (the "--system-site-
> packages" is required to pick up libnewt for the menu).
>
> Would you accept a patch to update the Getting Started page along these
> lines?

Sure.

That would also be the chance to mention
https://packages.debian.org/stable/kas or
https://packages.ubuntu.com/questing/kas (if latest is not most
important). Not sure if there are further distro packages by now as well.

Jan

--
Siemens AG, Foundational Technologies
Linux Expert Center