env icon indicating copy to clipboard operation
env copied to clipboard

Add troubleshooting section for Ubuntu 23.04+ installation issues

Open godmial opened this issue 3 months ago • 2 comments

Description

This PR adds a troubleshooting section to the README.md to help users resolve installation issues on Ubuntu 23.04 and later versions.

Problem

On Ubuntu 23.04+, the installation script may complete successfully, but users may encounter ModuleNotFoundError errors when using commands like pkgs or scons --menuconfig. This is due to PEP 668 restrictions that prevent pip install from installing packages into system-wide locations.

Solution

Added a new "Troubleshooting" section in the README.md that:

  • Explains the issue with PEP 668 restrictions on Ubuntu 23.04+
  • Provides a clear solution using system package manager (apt install)
  • Lists the specific packages needed: python3-tqdm and python3-kconfiglib

Changes

  • Added "Troubleshooting" section after "Prepare Env" section in README.md
  • Includes instructions for Ubuntu 23.04+ users to manually install missing dependencies

Testing

  • Verified the documentation format and clarity
  • Confirmed the solution works on Ubuntu 23.04+ systems

Related Issues

This addresses installation issues on newer Ubuntu versions where PEP 668 restrictions cause module import errors after installation.

godmial avatar Nov 28 '25 03:11 godmial