[Bug]: pyicu installation failure on ubuntu os via v sync --python 3.10 --all-extras

[HaiyangPeng]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (Language Policy).
• Non-english title submitions will be closed directly ( 非英文标题的提交将会被直接关闭 ) (Language Policy).
• Please do not modify this template :) and fill in all the required fields.

RAGFlow workspace code commit ID

7ed9efc

RAGFlow image version

7ed9efc

Other environment information

ubuntu 20.04
AMD cpu

Actual behavior

After I run the v sync --python 3.10 --all-extras command on ubuntu os, the following error occurs:

        self._finalize_license_expression()
      unicodeset.cpp: In function ‘int t_unicodesetiterator_init(t_unicodesetiterator*, PyObject*, PyObject*)’:
      unicodeset.cpp:1334:31: error: ‘class icu_66::UnicodeSetIterator’ has no member named ‘skipToStrings’
       1334 |                 self->object->skipToStrings();
            |                               ^~~~~~~~~~~~~
      error: command '/usr/bin/c++' failed with exit code 1

      hint: This usually indicates a problem with the package or the build environment.
  help: `pyicu` (v2.15) was included because `ragflow` (v0.19.0) depends on `pyicu`

Expected behavior

No response

Steps to reproduce

step1: activate python3.10 env
step2: run `sudo apt-get install libicu-dev pkg-config`
step3: run `uv sync --python 3.10 --all-extras`

Additional information

No response

[dosubot]

Hi @HaiyangPeng! I'm Dosu and I’m helping the ragflow team.

The error is caused by a mismatch between the version of the ICU library installed on your system and the version expected by PyICU. Specifically, the skipToStrings method is not present in the version of ICU (icu_66) provided by Ubuntu 20.04, but PyICU 2.15 expects it. This is a known issue when building PyICU against older ICU versions.

To resolve this, you need to upgrade your ICU library to a newer version (at least ICU 75 or higher). On Ubuntu, you can do this by manually downloading and building the latest ICU from source, or by using a prebuilt package if available. After upgrading ICU, set the appropriate environment variables so that PyICU can find the new ICU libraries during installation. For example:

# Download and build ICU from source (replace 76.1 with the latest version if needed)
wget https://github.com/unicode-org/icu/releases/download/release-76-1/icu4c-76_1-src.tgz
tar -xzf icu4c-76_1-src.tgz
cd icu/source
./configure --prefix=/opt/icu
make -j
sudo make install

# Set environment variables for the build
export LDFLAGS="-L/opt/icu/lib"
export CPPFLAGS="-I/opt/icu/include"
export LD_LIBRARY_PATH="/opt/icu/lib"

# Now try installing pyicu again
pip install pyicu

Alternatively, you can specify the ICU version when installing PyICU:

sudo ICU_VERSION=76 pip install pyicu

This approach has resolved similar issues for other users on Linux systems with outdated ICU libraries. More details and discussion can be found in this related issue: #5589.

Let me know if you need more detailed steps for building ICU or configuring your environment.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[voycey]

For those having this same issue on Mac since 15.2 upgrade:

1. install macports
2. /opt/local/bin/port search pyicu and install the one matching the python version you used with uv
3. remove xcode and re-install
4. rerun uv sync

[HaiyangPeng]

Hi @HaiyangPeng! I'm Dosu and I’m helping the ragflow team.

The error is caused by a mismatch between the version of the ICU library installed on your system and the version expected by PyICU. Specifically, the skipToStrings method is not present in the version of ICU (icu_66) provided by Ubuntu 20.04, but PyICU 2.15 expects it. This is a known issue when building PyICU against older ICU versions.

To resolve this, you need to upgrade your ICU library to a newer version (at least ICU 75 or higher). On Ubuntu, you can do this by manually downloading and building the latest ICU from source, or by using a prebuilt package if available. After upgrading ICU, set the appropriate environment variables so that PyICU can find the new ICU libraries during installation. For example:

Download and build ICU from source (replace 76.1 with the latest version if needed)

wget https://github.com/unicode-org/icu/releases/download/release-76-1/icu4c-76_1-src.tgz
tar -xzf icu4c-76_1-src.tgz
cd icu/source
./configure --prefix=/opt/icu
make -j
sudo make install

Set environment variables for the build

export LDFLAGS="-L/opt/icu/lib"
export CPPFLAGS="-I/opt/icu/include"
export LD_LIBRARY_PATH="/opt/icu/lib"

Now try installing pyicu again

pip install pyicu

Alternatively, you can specify the ICU version when installing PyICU:

sudo ICU_VERSION=76 pip install pyicu

This approach has resolved similar issues for other users on Linux systems with outdated ICU libraries. More details and discussion can be found in this related issue: #5589.

Let me know if you need more detailed steps for building ICU or configuring your environment.

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

thanks for your answer. Good!

[HaiyangPeng]

For those having this same issue on Mac since 15.2 upgrade:

1. install macports

2. `/opt/local/bin/port search pyicu` and install the one matching the python version you used with uv

3. remove xcode and re-install

4. rerun `uv sync`

Thanks for your help and I have solved this issue using compatible version of icu.