AB
AiBoss
project

Pi-Bolt - 把 Pi 编码代理预编译成原生可执行文件的独立分支

Pi-Bolt 是 Pi 编码代理的独立分支,把 Pi 的代码在构建时全部编译成机器码,产出 Linux x86-64、Apple silicon macOS 与 Windows x64 上的单一可执行文件,运行时不需要 JIT,也不需要 Node.js 或 Bun。项目自述其命令、会话、设置、provider 与扩展与 Pi 保持一致,并给出启动更快、会话 CPU 与内存占用更低的对比数据。

Pi-Bolt 是编码代理 Pi 的一个独立分支,做法是把 Pi 的代码在构建阶段全部编译成机器码,最终交付一个原生可执行文件。据项目自述,它面向的是已经在使用 Pi、但希望启动更快、长时间会话更省 CPU 与内存的用户:命令、会话、设置、provider 和扩展都与 Pi 保持一致,因此原有的使用习惯可以延续。项目同时说明自己是 Pi 的独立分支,与 Pi 的作者以及 Oven 没有隶属关系。

维护者与状态

仓库由 opensec-git 维护,地址为 github.com/opensec-git/Pi-Bolt,采用 MIT 许可证。仓库创建于 2026-10-02,最后一次提交在 2026-10-15,最新 release 为 bolt-v0.8.7,发布于 2026-10-15。截至 2026-10-15,该仓库获得 330 个星标。项目另有官网 pi-bolt.opensec.in。从时间线看,这是一个创建时间很短、但已经发布到 0.8.x 版本序列的项目。

主要能力

以下内容来自项目自述,未经本站验证。

  • 预编译为原生可执行文件。据项目说明,每个函数在构建可执行文件时就被编译成机器码,启动时不进行解析或 JIT 编译,因此运行时不需要 JIT,也不需要 Node.js 或 Bun。
  • 与 Pi 的使用方式保持一致。项目自述其命令、会话、设置、provider 与扩展与用户已经在用的 Pi 相同,并沿用 Pi 的 agent 目录 ~/.pi/agent,原有配置可直接使用。
  • 多平台单一可执行文件。项目称提供 Linux x86-64、Apple silicon 上的 macOS 以及 Windows x64 的可执行文件;安装脚本同一命令也覆盖 Linux ARM64 与 Android Termux。
  • 可选的 JIT 构建。默认构建不含 JIT,运行时加载的扩展以解释方式执行;对于做重活(搜索、解析)或使用 bun:ffi 的扩展,项目提供 JIT 构建,并称此时 Pi 自身仍保持编译状态,性能与默认构建相差约 5% 以内。
  • 安装器附带可选扩展。据项目说明,安装器会校验 release 签名,并提供三个由 OpenSec 提供的可选扩展:opensec-pi-subagents(独立会话中的专用代理、并行工作流与定时任务)、opensec-pi-todo(在编辑器上方以实时面板展示的待办列表)、opensec-pi-fff(pi-fff 的模糊查找、grep 与 @ 提及)。
  • 插件可编译进可执行文件。项目提供构建脚本,可把日常使用的插件编译进可执行文件,使其以机器码运行。
  • 与 Pi 并存。项目称 Pi-Bolt 以 pi-bolt 的名字与 Pi 并排安装,两者可以同时保留;用 pi-bolt 安装的包写入 Pi-Bolt 自己的列表 piBolt.packages,Pi 继续使用 packages,因此两者可以加载不同的包。

项目自述中给出了一组与 Pi 及其他实现的对比数据,覆盖启动时间、会话 CPU 与内存占用、大文件写入等指标,并说明测试方法与原始数据记录在仓库的文档中。这些数字属于维护者自述,本站未做复现。

使用入口

仓库地址:opensec-git/Pi-Bolt;官网:pi-bolt.opensec.in。

据项目说明,Linux、macOS 与 Android Termux 上可用同一条安装命令:

curl -fsSL https://pi-bolt.opensec.in/install.sh | sh

Windows 上在 PowerShell 中执行:

irm https://pi-bolt.opensec.in/install.ps1 | iex

也可以通过 npm 或 bun 全局安装,安装后在项目目录中运行 pi-bolt。项目称 pi-bolt update 会安装最新 release;若此前没有使用过 Pi,可运行 /login 连接 provider。选择 JIT 构建时,需要在安装命令前设置 PIBOLT_VARIANT 环境变量,例如 x64-jit 或 arm64-jit;使用 npm 安装时该变量需保留在 shell 配置中,因为每次运行都会读取。项目还提供手动下载构建产物的方式,并提示用 SHA256SUMS 校验。

许可与限制

许可证为 MIT。

据项目说明,运行环境存在以下边界:Linux 需要 x86-64 或 ARM64 且 glibc 2.17 或更高,不支持 musl;Android 需要 7 或更高版本、64 位 ARM,并在 Termux 中运行;macOS 需要 13 或更高版本且为 Apple silicon;Windows 需要 10(1809)或更高版本、或 Windows 11,且为 x64,Windows on ARM64 通过 Windows 11 的 x64 模拟运行 x64 构建。在 Termux 中,由于 Pi-Bolt 是 glibc 程序而 Android 的 libc 不是 glibc,安装器会先安装 Termux 的 glibc 并将其设为可执行文件的 loader。

此外,默认构建不含 JIT,运行时加载的扩展以解释方式执行,轻量扩展不受影响,做重活的扩展则建议改用 JIT 构建或将其编译进可执行文件。项目自述中的性能数字均为维护者提供的对比结果,实际表现会随硬件、平台与使用方式变化。