Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

docs: add Python installer tabs (#3481)

yufeng82f5383fd546
diff --git a/docs/en/getting-started/02-quickstart.md b/docs/en/getting-started/02-quickstart.md
index 5d59adafa..392b11204 100644
--- a/docs/en/getting-started/02-quickstart.md
+++ b/docs/en/getting-started/02-quickstart.md
@@ -14,12 +14,32 @@ Before using OpenViking, ensure your environment meets the following requirement
OpenViking can be installed via a Python Package to be used as a local library, or you can quickly launch it as an independent service using Docker.
-### Option 1: Install via pip (As a local library)
+### Option 1: Install as a Python package (local commands and library)
-```bash
+Choose your preferred Python package manager to install OpenViking:
+
+::: code-group
+
+```bash [uv (recommended)]
+uv tool install openviking --upgrade
+```
+
+```bash [pip]
pip install openviking --upgrade --force-reinstall
```
+```bash [pipx]
+# Install
+pipx install openviking
+
+# Update
+pipx upgrade openviking
+```
+
+:::
+
+After installation, use `ov` as the client command (`openviking` is an alias) and `openviking-server` as the server command.
+
### Option 2: Start via Docker (As an independent service)
If you prefer to run OpenViking as a standalone service, Docker is recommended.
diff --git a/docs/en/guides/17-vikingbot.md b/docs/en/guides/17-vikingbot.md
index 388c6a6e8..c159760c9 100644
--- a/docs/en/guides/17-vikingbot.md
+++ b/docs/en/guides/17-vikingbot.md
@@ -10,10 +10,28 @@ Python 3.11 or later is recommended for VikingBot.
### Install from PyPI
-```bash
-pip install "openviking[bot]"
+Choose your preferred Python package manager to install VikingBot:
+
+::: code-group
+
+```bash [uv (recommended)]
+uv tool install "openviking[bot]" --upgrade
+```
+
+```bash [pip]
+pip install "openviking[bot]" --upgrade --force-reinstall
```
+```bash [pipx]
+# Install
+pipx install "openviking[bot]"
+
+# Update
+pipx upgrade openviking
+```
+
+:::
+
Verify the installation:
```bash
diff --git a/docs/zh/getting-started/02-quickstart.md b/docs/zh/getting-started/02-quickstart.md
index 9bc778991..bc68b31df 100644
--- a/docs/zh/getting-started/02-quickstart.md
+++ b/docs/zh/getting-started/02-quickstart.md
@@ -14,12 +14,32 @@
OpenViking 支持通过 Python Package 安装作为本地库使用,也支持通过 Docker 快速启动独立服务。
-### 方式一:通过 pip 安装 (作为本地库)
+### 方式一:通过 Python 包安装(作为本地命令和库)
-```bash
+选择你常用的 Python 包管理工具安装 OpenViking:
+
+::: code-group
+
+```bash [uv(推荐)]
+uv tool install openviking --upgrade
+```
+
+```bash [pip]
pip install openviking --upgrade --force-reinstall
```
+```bash [pipx]
+# 安装
+pipx install openviking
+
+# 更新
+pipx upgrade openviking
+```
+
+:::
+
+安装完成后,可以使用客户端命令 `ov`(`openviking` 是其别名)和服务端命令 `openviking-server`。
+
### 方式二:通过 Docker 启动 (作为独立服务)
如果你希望将 OpenViking 作为独立的服务运行,推荐使用 Docker。
diff --git a/docs/zh/guides/17-vikingbot.md b/docs/zh/guides/17-vikingbot.md
index 182228f7a..b8562f0a3 100644
--- a/docs/zh/guides/17-vikingbot.md
+++ b/docs/zh/guides/17-vikingbot.md
@@ -10,10 +10,28 @@ VikingBot 建议使用 Python 3.11 或更高版本。
### 从 PyPI 安装
-```bash
-pip install "openviking[bot]"
+选择你常用的 Python 包管理工具安装 VikingBot:
+
+::: code-group
+
+```bash [uv(推荐)]
+uv tool install "openviking[bot]" --upgrade
+```
+
+```bash [pip]
+pip install "openviking[bot]" --upgrade --force-reinstall
```
+```bash [pipx]
+# 安装
+pipx install "openviking[bot]"
+
+# 更新
+pipx upgrade openviking
+```
+
+:::
+
安装后检查版本:
```bash