From ec1de025a8c399b0612662b8d066491b6e8be4cf Mon Sep 17 00:00:00 2001 From: godmial Date: Fri, 28 Nov 2025 11:46:35 +0800 Subject: [PATCH] docs: add troubleshooting section for Ubuntu 23.04+ installation issues --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 43a466b..8196009 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,14 @@ PLAN A: Whenever start the ubuntu system, you need to type command `source ~/.en or PLAN B: open `~/.bashrc` file, and attach the command `source ~/.env/env.sh` at the end of the file. It will be automatically executed when you log in the ubuntu, and you don't need to execute that command any more. +### Troubleshooting + +**For Ubuntu 23.04+:** The install script uses `pip install` which may fail on newer Ubuntu versions due to PEP 668 restrictions. If the installation completes but you encounter `ModuleNotFoundError` errors later (e.g., `ModuleNotFoundError: No module named 'tqdm'` or `ModuleNotFoundError: No module named 'kconfiglib'` when using `pkgs` or `scons --menuconfig`), manually install the missing dependencies: + +```bash +sudo apt install python3-tqdm python3-kconfiglib +``` + ### Use Env Please see: