From cb91dfb6f7d4c227cac6f1bd2097fb96a0686c5d Mon Sep 17 00:00:00 2001 From: Soulter <905617992@qq.com> Date: Tue, 14 Apr 2026 19:50:54 +0800 Subject: [PATCH] docs: update installation instructions to require Python 3.12 for `uv` deployment --- README.md | 5 +++-- README_fr.md | 5 +++-- README_ja.md | 5 +++-- README_ru.md | 5 +++-- README_zh-TW.md | 5 +++-- README_zh.md | 5 +++-- docs/en/deploy/astrbot/package.md | 6 ++++-- docs/zh/deploy/astrbot/package.md | 6 ++++-- 8 files changed, 26 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 16ea78ea7..6774d4305 100644 --- a/README.md +++ b/README.md @@ -77,12 +77,13 @@ AstrBot is an open-source all-in-one Agent chatbot platform that integrates with For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a `uv` environment on their own, we recommend the `uv` one-click deployment method ⚡️: ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # Only execute this command for the first time to initialize the environment astrbot run ``` > Requires [uv](https://docs.astral.sh/uv/) to be installed. +> AstrBot requires Python 3.12 or later. The `--python 3.12` option ensures that `uv` creates the tool environment with Python 3.12. > [!NOTE] > For macOS user: due to macOS security checks, the first run of the `astrbot` command may take longer (about 10-20s). @@ -90,7 +91,7 @@ astrbot run Update `astrbot`: ```bash -uv tool upgrade astrbot +uv tool upgrade astrbot --python 3.12 ``` > [!WARNING] diff --git a/README_fr.md b/README_fr.md index f64582f3a..c7dbeac3c 100644 --- a/README_fr.md +++ b/README_fr.md @@ -76,12 +76,13 @@ AstrBot est une plateforme de chatbot Agent tout-en-un open source qui s'intègr Pour les utilisateurs qui veulent découvrir AstrBot rapidement, qui sont familiers avec la ligne de commande et peuvent installer eux-mêmes l'environnement `uv`, nous recommandons la méthode de déploiement en un clic avec `uv` ⚡️ : ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # Exécutez cette commande uniquement la première fois pour initialiser l'environnement astrbot run ``` > [uv](https://docs.astral.sh/uv/) doit être installé. +> AstrBot nécessite Python 3.12 ou une version plus récente. L'option `--python 3.12` garantit que `uv` crée l'environnement tool avec Python 3.12. > [!NOTE] > Pour les utilisateurs macOS : en raison des vérifications de sécurité de macOS, la première exécution de la commande `astrbot` peut prendre plus de temps (environ 10-20s). @@ -89,7 +90,7 @@ astrbot run Mettre à jour `astrbot` : ```bash -uv tool upgrade astrbot +uv tool upgrade astrbot --python 3.12 ``` > [!WARNING] diff --git a/README_ja.md b/README_ja.md index 16529764d..1e91a0ebc 100644 --- a/README_ja.md +++ b/README_ja.md @@ -76,12 +76,13 @@ AstrBot は、主要なインスタントメッセージングアプリと統合 AstrBot を素早く試したいユーザーで、コマンドラインに慣れており `uv` 環境を自分でインストールできる場合は、`uv` のワンクリックデプロイをおすすめします ⚡️: ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # 初回のみ実行して環境を初期化します astrbot run ``` > [uv](https://docs.astral.sh/uv/) のインストールが必要です。 +> AstrBot には Python 3.12 以降が必要です。`--python 3.12` を指定すると、`uv` は Python 3.12 で tool 環境を作成します。 > [!NOTE] > macOS ユーザーの場合：macOS のセキュリティチェックにより、`astrbot` コマンドの初回実行に時間がかかる場合があります（約 10〜20 秒）。 @@ -89,7 +90,7 @@ astrbot run `astrbot` の更新： ```bash -uv tool upgrade astrbot +uv tool upgrade astrbot --python 3.12 ``` > [!WARNING] diff --git a/README_ru.md b/README_ru.md index b495825b0..a1fb90678 100644 --- a/README_ru.md +++ b/README_ru.md @@ -76,12 +76,13 @@ AstrBot — это универсальная платформа Agent-чатб Для пользователей, которые хотят быстро попробовать AstrBot, знакомы с командной строкой и могут самостоятельно установить окружение `uv`, мы рекомендуем использовать развёртывание в один клик через `uv` ⚡️: ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # Выполните эту команду только при первом запуске для инициализации окружения astrbot run ``` > Требуется установленный [uv](https://docs.astral.sh/uv/). +> Для AstrBot требуется Python 3.12 или новее. Параметр `--python 3.12` гарантирует, что `uv` создаст tool-окружение с Python 3.12. > [!NOTE] > Для пользователей macOS: из-за проверок безопасности macOS первый запуск команды `astrbot` может занять больше времени (около 10-20 секунд). @@ -89,7 +90,7 @@ astrbot run Обновить `astrbot`: ```bash -uv tool upgrade astrbot +uv tool upgrade astrbot --python 3.12 ``` > [!WARNING] diff --git a/README_zh-TW.md b/README_zh-TW.md index 92a4c675e..da5f3abf4 100644 --- a/README_zh-TW.md +++ b/README_zh-TW.md @@ -76,12 +76,13 @@ AstrBot 是一個開源的一站式 Agent 聊天機器人平台，可接入主 對於想快速體驗 AstrBot、且熟悉命令列並能自行安裝 `uv` 環境的使用者，我們推薦使用 `uv` 一鍵部署方式 ⚡️。 ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # 僅首次執行此命令以初始化環境 astrbot run ``` > 需要安裝 [uv](https://docs.astral.sh/uv/)。 +> AstrBot 需要 Python 3.12 或更高版本。`--python 3.12` 會確保 `uv` 使用 Python 3.12 建立 tool 環境。 > [!NOTE] > 對於 macOS 使用者：由於 macOS 安全性檢查，首次執行 `astrbot` 指令可能需要較長時間（約 10-20 秒）。 @@ -89,7 +90,7 @@ astrbot run 更新 `astrbot`： ```bash -uv tool upgrade astrbot +uv tool upgrade astrbot --python 3.12 ``` > [!WARNING] diff --git a/README_zh.md b/README_zh.md index 5f5fa8b10..52a1f3672 100644 --- a/README_zh.md +++ b/README_zh.md @@ -76,12 +76,13 @@ AstrBot 是一个开源的一站式 Agentic 个人和群聊助手，可在 QQ、 对于想快速体验 AstrBot、且熟悉命令行并能够自行安装 `uv` 环境的用户，我们推荐使用 `uv` 一键部署方式 ⚡️。 ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # 仅首次执行此命令以初始化环境 astrbot run ``` > 需要安装 [uv](https://docs.astral.sh/uv/)。 +> AstrBot 需要 Python 3.12 或更高版本。`--python 3.12` 会确保 `uv` 使用 Python 3.12 创建 tool 环境。 > [!NOTE] > 对于 macOS 用户：由于 macOS 安全检查，首次运行 `astrbot` 命令可能需要较长时间（约 10-20 秒）。 @@ -89,7 +90,7 @@ astrbot run 更新 `astrbot`： ```bash -uv tool upgrade astrbot +uv tool upgrade astrbot --python 3.12 ``` > [!WARNING] diff --git a/docs/en/deploy/astrbot/package.md b/docs/en/deploy/astrbot/package.md index 22207fdfd..c921f209d 100644 --- a/docs/en/deploy/astrbot/package.md +++ b/docs/en/deploy/astrbot/package.md @@ -12,11 +12,13 @@ If `uv` is not installed, install it first by following the official guide: ## Important Notes > [!WARNING] -> AstrBot deployed via `uv` **does not support upgrading through the WebUI**. To update, run `uv tool upgrade astrbot` from the command line. +> AstrBot deployed via `uv` **does not support upgrading through the WebUI**. To update, run `uv tool upgrade astrbot --python 3.12` from the command line. + +AstrBot requires Python 3.12 or later. Use `--python 3.12` to ensure that `uv` creates the tool environment with Python 3.12; if Python downloads are enabled, `uv` will download Python 3.12 automatically when it is missing. ## Install and Start ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot ``` diff --git a/docs/zh/deploy/astrbot/package.md b/docs/zh/deploy/astrbot/package.md index a8345e010..96a50f55a 100644 --- a/docs/zh/deploy/astrbot/package.md +++ b/docs/zh/deploy/astrbot/package.md @@ -11,12 +11,14 @@ ## 注意事项 > [!WARNING] -> 通过 `uv` 部署的 AstrBot **不支持在 WebUI 中进行版本升级**。如需更新，请在命令行中执行 `uv tool upgrade astrbot`。 +> 通过 `uv` 部署的 AstrBot **不支持在 WebUI 中进行版本升级**。如需更新，请在命令行中执行 `uv tool upgrade astrbot --python 3.12`。 + +AstrBot 需要 Python 3.12 或更高版本。使用 `--python 3.12` 可以确保 `uv` 使用 Python 3.12 创建 tool 环境；如果启用了 Python 自动下载，`uv` 会在缺少 Python 3.12 时自动下载。 ## 安装并启动 ```bash -uv tool install astrbot +uv tool install astrbot --python 3.12 astrbot init # 只需要在第一次部署时执行，后续启动不需要执行 astrbot run ```