跳转到内容
Pinix

本地安装

Pinix 有两种安装方式，取决于你的使用场景：

安装方式适合谁安装什么
完整安装要在这台机器上运行 Clip 的人daemon + CLI + 浏览器引擎 + 运行时
CLI-only要远程调用别人 Clip 的人只装 pinix 命令行

典型场景：一台服务器做完整安装跑 daemon 和 Clip，团队其他人在自己电脑上装 CLI-only 远程调用。或者你已经在用 pinixai.com 云端 Agent，只想在终端里也能调用 Clip。

系统要求

Section titled “系统要求”
macOSLinuxWindows
完整安装arm64 / amd64arm64 / amd64amd64
CLI-onlyarm64 / amd64arm64 / amd64amd64

完整安装

Section titled “完整安装”

安装 daemon + 所有依赖，在本机运行 Clip。

Terminal window
curl -fsSL dl.pinixai.com/install.sh | sh

自动安装的组件：

组件用途
pinixCLI + daemon（单一二进制）
Node.js运行时依赖（没有会自动安装）
BunClip 运行时——运行 TypeScript Clip
bb-browser浏览器自动化 Edge Clip

Chrome 会在首次启动 daemon 时自动下载。

启动

Section titled “启动”

  1. 启动 daemon

    Terminal window
    pinix start

    daemon 启动在 :9000 端口，同时自动拉起 Chrome 和 bb-browser。

  2. 登录

    Terminal window
    # 浏览器授权（会自动打开浏览器）
    pinix login
    

    # 或者用 token 登录（从 pinixai.com/settings 获取 token）
    pinix login --token pnx_...

    登录后，daemon 自动连接 Cloud Hub——你的本地 Clip 从云端也能访问，你也能用到别人共享的 Clip。

  3. 开始使用

    Terminal window
    # 查看可用的 Clip
    pinix hub list
    

    # bb-browser 的平台 Clip 已自动注册
    pinix invoke hackernews top
    pinix invoke google search "pinix ai agent"
    

    # 安装更多 Clip
    pinix hub add @pinix/todo
    pinix invoke todo list
    

    # 打开本地 Console
    open http://localhost:9000

CLI-only 安装

Section titled “CLI-only 安装”

只安装 pinix 命令行工具，不启动 daemon，不装运行时。通过 Cloud Hub 或远程 daemon 调用 Clip。

Terminal window
curl -fsSL dl.pinixai.com/install.sh | sh -s -- --cli

登录

Section titled “登录”

安装后需要登录，有两种方式：

Terminal window
pinix login

会打印一个链接并自动打开浏览器，在网页上确认授权即可。

登录后，CLI 自动连接 Cloud Hub。不需要手动指定 --server，直接使用：

Terminal window
# 查看所有可用的 Clip（你自己的 + 别人共享的）
pinix hub list


# 调用 Clip
pinix invoke todo list
pinix invoke hackernews top

直连局域网 daemon

Section titled “直连局域网 daemon”

如果不走 Cloud Hub，也可以直接连接局域网内另一台机器的 daemon：

Terminal window
pinix --server http://192.168.1.100:9000 hub list
pinix --server http://192.168.1.100:9000 invoke todo list

常用命令

Section titled “常用命令”
命令说明需要 daemon
pinix start启动 daemon—
pinix stop停止 daemon—
pinix login登录否
pinix whoami查看登录状态否
pinix hub list查看 Clip 列表是
pinix hub add @scope/name安装 Clip是
pinix hub remove <alias>卸载 Clip是
pinix hub update [alias]更新 Clip 到最新版是
pinix hub info <alias>查看 Clip 命令和参数是
pinix invoke <alias> <command>调用 Clip是
pinix registry search <query>搜索 Registry否
pinix upgrade升级 Pinix 自身否

从源码构建

Section titled “从源码构建”

需要 Go 1.25+：

Terminal window
git clone https://github.com/epiral/pinix.git
cd pinix
make build

还需要单独安装 Bun 和 bb-browser：

Terminal window
curl -fsSL https://bun.sh/install | bash
npm install -g bb-browser

更新 Clip

Section titled “更新 Clip”
Terminal window
# 更新单个 Clip 到最新版
pinix hub update todo


# 更新所有 Registry 安装的 Clip
pinix hub update --all


# 更新到指定版本
pinix hub update todo --version 1.2.0

升级 Pinix

Section titled “升级 Pinix”
Terminal window
pinix upgrade

升级 Pinix 自身的二进制，同时更新 bb-browser。这不影响已安装的 Clip。

下一步

Section titled “下一步”