From 0ced071a0b702e445f13cc59704a0986b59d9e5c Mon Sep 17 00:00:00 2001
From: Qi Wang <wangq8@outlook.com>
Date: Wed, 8 Apr 2026 10:33:46 +0800
Subject: [PATCH] Use uv run python3 x.py instead of uv run x.py (#13966)

### Use uv run python3 x.py instead of uv run x.py

When directly call `uv run x.py` it will use the python in shebang, it
does not work if the default python lack of some packages, so change it
to best practices `uv run python3 x.py`

### Type of change

- [x] Documentation Update

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes

* **Documentation**
* Updated development setup instructions across all README files
(English and multiple language translations) to use explicit Python
interpreter invocation for the dependency download command.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---
 README.md       | 2 +-
 README_ar.md    | 2 +-
 README_fr.md    | 2 +-
 README_id.md    | 2 +-
 README_ja.md    | 2 +-
 README_ko.md    | 2 +-
 README_pt_br.md | 2 +-
 README_tr.md    | 2 +-
 README_tzh.md   | 2 +-
 README_zh.md    | 2 +-
 10 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 6ad0035300..62a108ed62 100644
--- a/README.md
+++ b/README.md
@@ -329,7 +329,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. Launch the dependent services (MinIO, Elasticsearch, Redis, and MySQL) using Docker Compose:
diff --git a/README_ar.md b/README_ar.md
index 0f8d95b8cd..6efb7188e2 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -329,7 +329,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. قم بتشغيل الخدمات التابعة (MinIO وElasticsearch وRedis وMySQL) باستخدام Docker Compose:
diff --git a/README_fr.md b/README_fr.md
index 8630cd85cb..019c016bb9 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -320,7 +320,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. Lancez les services dépendants (MinIO, Elasticsearch, Redis et MySQL) avec Docker Compose :
diff --git a/README_id.md b/README_id.md
index ec1ed71d59..416822fb19 100644
--- a/README_id.md
+++ b/README_id.md
@@ -303,7 +303,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. Jalankan aplikasi yang diperlukan (MinIO, Elasticsearch, Redis, dan MySQL) menggunakan Docker Compose:
diff --git a/README_ja.md b/README_ja.md
index bc06fdc47d..2c06d88c56 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -303,7 +303,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. Docker Compose を使用して依存サービス（MinIO、Elasticsearch、Redis、MySQL）を起動する:
diff --git a/README_ko.md b/README_ko.md
index 1865809601..23ed55aee5 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -298,7 +298,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 
diff --git a/README_pt_br.md b/README_pt_br.md
index c1c551dc5b..9e4ebae263 100644
--- a/README_pt_br.md
+++ b/README_pt_br.md
@@ -320,7 +320,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # instala os módulos Python dependentes do RAGFlow
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. Inicie os serviços dependentes (MinIO, Elasticsearch, Redis e MySQL) usando Docker Compose:
diff --git a/README_tr.md b/README_tr.md
index b0d6e3023e..cd3f43fdf1 100644
--- a/README_tr.md
+++ b/README_tr.md
@@ -324,7 +324,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # RAGFlow'un bağımlı Python modüllerini yükler
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. Bağımlı hizmetleri (MinIO, Elasticsearch, Redis ve MySQL) Docker Compose kullanarak başlatın:
diff --git a/README_tzh.md b/README_tzh.md
index bfa131f7b7..6bc3f67142 100644
--- a/README_tzh.md
+++ b/README_tzh.md
@@ -330,7 +330,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```
 3. 透過 Docker Compose 啟動依賴的服務（MinIO, Elasticsearch, Redis, and MySQL）：
diff --git a/README_zh.md b/README_zh.md
index d45dd0c1a0..950fcd9833 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -330,7 +330,7 @@ docker build --platform linux/amd64 \
    git clone https://github.com/infiniflow/ragflow.git
    cd ragflow/
    uv sync --python 3.12 # install RAGFlow dependent python modules
-   uv run download_deps.py
+   uv run python3 download_deps.py
    pre-commit install
    ```