Skip to content

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

feat: wrapper ov command (#325)

MaojiaSheng7ae7bfb5dd20
diff --git a/.github/workflows/_build.yml b/.github/workflows/_build.yml
index 8266ae6eb..ae8b145d6 100644
--- a/.github/workflows/_build.yml
+++ b/.github/workflows/_build.yml
@@ -182,12 +182,15 @@ jobs:
echo "LD_LIBRARY_PATH=${PYTHON_PREFIX}/lib:${LD_LIBRARY_PATH}" >> "$GITHUB_ENV"
export LD_LIBRARY_PATH="${PYTHON_PREFIX}/lib:${LD_LIBRARY_PATH}"
"$PYTHON_BIN" -V
-
- name: Set up Go
uses: actions/setup-go@v6
with:
go-version: '1.25.1'
+ - name: Set up Rust
+ uses: dtolnay/rust-toolchain@v1
+ with:
+ toolchain: stable
- name: Install uv
uses: astral-sh/setup-uv@v7
with:
@@ -205,6 +208,14 @@ jobs:
- name: Install build dependencies
run: uv pip install setuptools setuptools_scm pybind11 cmake wheel build
+ - name: Build Rust CLI (Linux)
+ run: cargo build --release --target x86_64-unknown-linux-gnu -p ov_cli
+
+ - name: Copy Rust CLI binary (Linux)
+ run: |
+ mkdir -p openviking/bin
+ cp target/x86_64-unknown-linux-gnu/release/ov openviking/bin/
+ chmod +x openviking/bin/ov
- name: Clean workspace (force ignore dirty)
shell: bash
run: |
@@ -298,6 +309,10 @@ jobs:
with:
go-version: '1.25.1'
+ - name: Set up Rust
+ uses: dtolnay/rust-toolchain@v1
+ with:
+ toolchain: stable
- name: Install uv
uses: astral-sh/setup-uv@v7
with:
@@ -319,6 +334,25 @@ jobs:
- name: Install build dependencies
run: uv pip install setuptools setuptools_scm pybind11 cmake wheel build
+ - name: Build Rust CLI (macOS/Windows)
+ shell: bash
+ run: |
+ if [[ "${{ matrix.os }}" == "windows-latest" ]]; then
+ cargo build --release --target x86_64-pc-windows-msvc -p ov_cli
+ else
+ cargo build --release -p ov_cli
+ fi
+
+ - name: Copy Rust CLI binary (macOS/Windows)
+ shell: bash
+ run: |
+ mkdir -p openviking/bin
+ if [[ "${{ matrix.os }}" == "windows-latest" ]]; then
+ cp target/x86_64-pc-windows-msvc/release/ov.exe openviking/bin/
+ else
+ cp target/release/ov openviking/bin/
+ chmod +x openviking/bin/ov
+ fi
- name: Clean workspace (force ignore dirty)
shell: bash
run: |
diff --git a/openviking/cli.py b/openviking/cli.py
new file mode 100644
index 000000000..34adc3d8a
--- /dev/null
+++ b/openviking/cli.py
@@ -0,0 +1,86 @@
+"""ov 命令的极简 Python 包装器
+
+设计原则:
+1. 职责单一:仅负责查找二进制并 execv
+2. 无网络依赖:不实现下载功能
+3. 极简代码:尽可能减少启动开销
+4. 快速失败:找不到立即提示用户
+
+性能说明:
+- Python 虚拟机启动 + 导入基础模块:约 30-50ms
+- 一旦 execv 执行,后续为纯 Rust 二进制,零开销
+
+Rust CLI 独立发布能力完全保留,用户可通过以下方式获取:
+- 官方安装脚本(零开销)
+- GitHub Releases 手动下载(零开销)
+- cargo install(零开销)
+- 包管理器(未来)
+"""
+
+import os
+import sys
+from pathlib import Path
+from shutil import which
+
+
+def main():
+ """
+ 极简入口点:查找 ov 二进制并执行
+
+ 按优先级查找:
+ 1. Wheel 自带:{package_dir}/openviking/bin/ov
+ 2. PATH 查找:系统全局安装的 ov
+ """
+ # 1. 检查 Wheel 自带(不导入 openviking,避免额外开销)
+ try:
+ # __file__ is openviking/cli.py, so parent is openviking directory
+ package_dir = Path(__file__).parent
+ package_bin = package_dir / "bin"
+ for binary_name in ["ov", "ov.exe"]:
+ binary = package_bin / binary_name
+ if binary.exists() and os.access(binary, os.X_OK):
+ # 找到后立即 execv,不返回
+ args = [str(binary)] + sys.argv[1:]
+ os.execv(str(binary), args)
+ except Exception:
+ pass
+
+ # 2. 检查 PATH,但跳过当前 Python 脚本
+ path_binary = which("ov")
+ if path_binary:
+ # 检查文件是否是 Python 脚本(避免无限循环)
+ try:
+ candidate_path = Path(path_binary).resolve()
+ with open(candidate_path, "rb") as f:
+ first_bytes = f.read(2)
+ # Skip if it starts with #! (shebang, likely Python script)
+ if first_bytes != b"#!":
+ args = [path_binary] + sys.argv[1:]
+ os.execv(path_binary, args)
+ except Exception:
+ pass
+
+ # 都找不到,提示用户
+ print(
+ """错误: 未找到 ov 二进制文件。
+
+ 请选择以下方式之一安装:
+
+ 1. 使用预构建 wheel(推荐):
+ pip install openviking
+
+ 2. 使用官方安装脚本(零 Python 开销):
+ curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/crates/ov_cli/install.sh | bash
+
+ 3. 从 GitHub Releases 下载(零 Python 开销):
+ https://github.com/volcengine/OpenViking/releases
+
+ 4. 从源码构建(零 Python 开销):
+ cargo install --git https://github.com/volcengine/OpenViking ov_cli""",
+ file=sys.stderr,
+ )
+ return 1
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/pyproject.toml b/pyproject.toml
index 25050f2a5..dc4b6628a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -89,7 +89,8 @@ Repository = "https://github.com/volcengine/openviking"
Issues = "https://github.com/volcengine/openviking/issues"
[project.scripts]
-openviking = "openviking_cli.cli.main:app"
+ov = "openviking.cli:main" # Rust CLI 入口(极简包装器)
+# openviking = "openviking_cli.cli.main:app" # 可选:保留或移除
openviking-server = "openviking.server.bootstrap:main"
[tool.setuptools_scm]
@@ -103,7 +104,13 @@ include = ["openviking*"]
exclude = ["tests*", "docs*", "examples*"]
[tool.setuptools.package-data]
-openviking = ["prompts/templates/**/*.yaml"]
+openviking = [
+ "prompts/templates/**/*.yaml",
+ "bin/agfs-server",
+ "bin/agfs-server.exe",
+ "bin/ov", # 新增
+ "bin/ov.exe" # 新增
+]
[tool.mypy]
python_version = "3.10"
diff --git a/setup.py b/setup.py
index 8a8089c4a..a39f01d60 100644
--- a/setup.py
+++ b/setup.py
@@ -198,6 +198,8 @@ setup(
"bin/libagfsbinding.so",
"bin/libagfsbinding.dylib",
"bin/libagfsbinding.dll",
+ "bin/ov", # 新增
+ "bin/ov.exe", # 新增
],
},
include_package_data=True,