【免费下载链接】PiGPiG (Pi in Go) is a faithful Go port of upstream Pi, the TypeScript codebase behind the Pi coding agent. It is a parity-bound translation, not a rewrite: upstream behavior is the contract, and Go is the implementation language.项目地址https://gitcode.com/gh_mirrors/pig18/PiG点击查看免费下载PiGPi in Go是用 Go 原生重写的终端编程智能体最大特点是单二进制交付不需要 Node.js、没有运行时依赖下载即用。这篇 PiG 部署指南覆盖四条路线——单二进制快速安装、Docker 容器隔离、Android Termux 手机部署、远程无界面环境并附上部署清单帮你排坑。先认识一下 PiG 的终端形态启动后即可对话、执行命令、读写文件 30秒选择你的PiG部署方式你的环境推荐部署方式关键点macOS / Linux 桌面安装脚本单二进制一条命令自动校验 SHA-256Windows预览支持PowerShell 安装脚本官方标注为预览已装 Node.js 18npm 全局安装跨平台兜底方案Go 开发者go install源码即装可锁定版本CI / 共享服务器 / 需要隔离Docker 容器官方无现成镜像需自建Android 手机Termux只能使用android-arm64二进制远程服务器 / 无图形界面SSH tmux 非交互模式配PIG_OFFLINE更适合 CI 方案一单二进制部署60秒完成这是最推荐的 PiG 部署方式。macOS / Linux 一键安装curl -fsSL https://pi-in-go.dev/install.sh | sh pig --version脚本会下载最新 release、用SHA256SUMS校验完整性并把pig装进~/.local/bin。如果该目录不在PATH中脚本会直接打印需要追加的export PATH...一行照做后重开终端即可。脚本安装支持pig update自升级。WindowsPowerShellirm https://pi-in-go.dev/install.ps1 | iexnpm 与 Go 两条备用路线npm install -g pi-in-go/pig # Node.js 18 go install github.com/MichaelKinsy/PiG/cmd/piglatest # Go 1.26npm 安装的是原生二进制pi-in-go/pig-os-cpu平台包注意不要加--omitoptional否则二进制会被省略。go install会把可执行文件写到~/go/binGOBIN或GOPATH的bin目录记得加入PATH。从源码构建git clone https://gitcode.com/gh_mirrors/pig18/PiG cd PiG go build -o bin/pig ./cmd/pig ./bin/pig --version构建需要 Go 1.27.3release 构建所用的版本与 Git完整验证套件还需要 Node.js、Python、Rust、tmux 等工具参考 Makefile 中的check目标。首次启动三步设置向导第一次交互式启动PiG 会问三个问题选主题、选页眉小精灵、是否共享匿名使用数据。全部Enter接受或Esc跳过均可答案写入~/.pig/agent/settings.json之后不再询问连接第一个模型登录后主界面会出现No models available. Use /login ...的提示这正是下一步两种方式二选一交互登录启动pig后输入/login走 OAuthChatGPT、GitHub Copilot、OpenRouter 等或 API Key也可用pig login --list查看可用目标环境变量如export OPENAI_API_KEY...再pig --model openai/gpt-4.1启动。各 provider 读取的环境变量见 docs/site/docs/providers.md。配置根目录默认是~/.pig可用PIG_HOME整体迁移用户状态、会话、凭据都保存在此目录下的agent/中。 方案二Docker容器部署官方不提供现成镜像推荐用多阶段 Dockerfile 从源码树构建出处docs/site/docs/containerization.md。容器提供操作系统级边界可限制文件系统、进程、设备与网络访问——PiG 本身不隔离模型输出需要隔离时这是正解见 docs/site/docs/security.md。在项目根目录创建DockerfileFROM golang:1.27.3 AS build WORKDIR /src COPY . . RUN CGO_ENABLED0 go build -buildvcsfalse -trimpath -o /out/pig ./cmd/pig FROM debian:bookworm-slim RUN apt-get update \ apt-get install -y --no-install-recommends bash ca-certificates git ripgrep \ rm -rf /var/lib/apt/lists/* RUN useradd --create-home --uid 10001 pig COPY --frombuild /out/pig /usr/local/bin/pig USER pig WORKDIR /workspace ENTRYPOINT [pig]docker build -t pig-local .几个细节ca-certificates用于校验模型服务端的 TLS 证书ripgrep服务于内置grep工具缺网时 PiG 无法自动补下。发布构建建议用摘要digest锁定基础镜像并生成 SBOM 后扫描。用卷持久化配置与会话PiG 的用户状态都在~/.pig想让 Session 和设置跨越容器重建存活挂一个命名卷docker run --rm -it \ -e ANTHROPIC_API_KEY \ -v pig-home:/home/pig/.pig \ -v $PWD:/workspace \ pig-local⚠️ 不要把宿主的~/.pig直接挂进去——那等于把宿主的凭据、会话、扩展状态全交给容器非必要请用独立卷。只读工作区与网络隔离只允许看不允许改-v $PWD:/workspace:ro一次性非交互运行docker run --rm -it -v $PWD:/workspace:ro pig-local -p Review this repository任务不需要外部调用时直接--network none正常模型推理需要网络除非端点在允许的内网。安全要点运行时用非 root 用户Dockerfile 里已USER pig密钥在运行时注入环境变量、属主独占的挂载文件或外部密钥解析器不要烤进镜像层默认不给 Docker socket、设备访问与额外 Linux capability。 方案三TermuxAndroid部署PiG 官方支持通过 Termux。步骤pkg update pkg upgrade pkg install curl git curl -fsSL https://pi-in-go.dev/install.sh | sh # 自动识别 Termux装 android-arm64 版本 pig --version也可走 npmpkg install nodejs npm install -g pi-in-go/pig。常用补充配置pkg install ripgrep fd # PiG 在 Android 上不会自动下载这两个工具 termux-setup-storage # 一次性授权访问 Android 共享存储 pkg install termux-api # 需要剪贴板复制/粘贴时安装三个高频坑必须用android-arm64二进制。手动装linux-arm64会报has unexpected e_type: 2Termux 的加载器无法启动它只有 arm64 有 release 二进制32 位或 x86 设备需从源码构建pkg install git golang包版本低于 1.27.3 时设GOTOOLCHAINlocalTermux 里没有 Podman/Docker容器化构建 Piglet 不可用。️ 方案四远程服务器与无头环境远程部署 方案一的单二进制 会话保持 非交互调用。SSH tmux 保持会话远程服务器断开 SSH 后让 PiG 继续跑用 tmux 最稳妥。tmux 默认会吞掉部分修饰键在~/.tmux.conf加上set -g extended-keys on set -g extended-keys-format csi-u配置细节见 docs/site/docs/tmux.md。会话中长任务示例非交互模式自动化脚本里用-p一次性给出提示跑完即退适合 cron / 流水线。CI 环境设置PIG_OFFLINE1或加--offline关掉启动时的更新检查与目录刷新避免网络受限时卡慢代理可用HTTP_PROXY/HTTPS_PROXY。完整变量表见 docs/site/docs/environment-variables.md。隔离试验不想污染本机配置时把配置根指到空目录pig diagnose可随时确认读写位置PIG_HOME/tmp/scratch pig diagnose✅ PiG部署排错清单症状原因与解法pig: command not found~/.local/bin或~/go/bin不在PATH按安装提示export后重开终端has unexpected e_type: 2Termux 里误装了linux-arm64二进制重装即可No models available还没登录输入/login或设置 API Key 环境变量CI 中启动很慢设PIG_OFFLINE1关闭启动期网络请求npm 装完没有二进制别加--omitoptional平台包是可选依赖更多安装问题见 docs/site/docs/install-troubleshooting.md。 延伸阅读快速上手docs/site/docs/quickstart.md前10分钟教程docs/site/docs/first-run.md容器化与安全边界docs/site/docs/containerization.md、docs/site/docs/security.mdAndroid 部署docs/site/docs/termux.md终端与按键配置docs/site/docs/terminal-setup.md按本文顺序走一遍你的 PiG 部署就能覆盖桌面、容器、手机与远程服务器四类环境。从最快的单二进制起步需要隔离时再升级到容器是最平滑的路线。赞分享【免费下载链接】PiGPiG (Pi in Go) is a faithful Go port of upstream Pi, the TypeScript codebase behind the Pi coding agent. It is a parity-bound translation, not a rewrite: upstream behavior is the contract, and Go is the implementation language.项目地址https://gitcode.com/gh_mirrors/pig18/PiG点击查看免费下载相关推荐Ponzu部署终极指南单二进制文件与Docker完整方案Ponzu部署终极指南单二进制文件与Docker完整方案 Ponzu是一款基于Go语言开发的无头内容管理系统Headless CMS提供自动JSON ACMS后端Data Formulator 上手指南接入数据、自然语言提问生成可编辑的时序可视化图表Data Formulator 上手指南接入数据、自然语言提问生成可编辑的时序可视化图表 Data Formulator 是一个开源的 AI 数据可视化工具人工智能AI 应用数据可视化数据分析前端后端AI Agent大模型Umi-OCR完全指南免费离线OCR工具如何5分钟提升你的工作效率Umi OCR完全指南免费离线OCR工具如何5分钟提升你的工作效率 还在为每天处理大量纸质文档而烦恼吗面对扫描件、截图中的文字你是否还在手动输入到深夜在桌面应用OCR计算机视觉上一篇Attractor DOT DSL教程用Graphviz语法画出你的第一张AI工作流图下一篇my-translator四大翻译引擎全面对比Soniox vs OpenAI Realtime vs Qwen vs 本地MLX到底该选哪个创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
