跳到主要内容

安装

安装的验收点是：当前终端可以运行正确的 anyy --version。模型配置和常驻服务属于后续步骤，安装脚本不会替你选择服务商。

你的设备能使用哪一个包？​

v0.1.107 发布以下四个平台的原生产物：

系统架构
macOSApple Silicon 的 arm64、Intel 的 amd64
Linuxarm64／aarch64、amd64／x86_64

原生安装器不支持 Windows，也不提供 arm32 包。发行程序使用 Go 构建；运行 Anyy 本身不要求安装 Go 或 Node.js。外部 MCP 服务器和工具可能另有依赖。

准备可以访问 anyy.ai 的网络，以及 sh、curl、tar、gzip、awk、sed、mktemp、readlink 和 sha256sum／shasum。普通用户可以安装到自己的目录，不必切到 root。

执行安装​

curl -fsSL https://anyy.ai/install.sh | sh
anyy --version

脚本会选择系统和架构，下载发行包与校验文件，确认 SHA-256 和归档路径合法，再把程序放入独立版本目录并原子切换 current。同一个 Home 的安装／更新有锁，不能并发切换。

希望先阅读脚本时，直接查看 install.sh。版本来自最新发布指针，本手册对应 v0.1.107。

成功输出会包含 Installed Anyy ...。Gateway: 只是当前状态报告，不表示安装器启动了服务；新安装出现 Gateway: status unavailable 时，应先单独确认 --version 正常。

命令找不到时，先看安装输出​

安装器打印 Binary: 时，使用后面的完整路径运行 --version，再按输出提示添加 PATH。普通用户的入口通常是：

$HOME/.local/bin/anyy

脚本不修改 Shell 启动文件，也不覆盖归属不明的同名命令。不要在没有核对来源时删除另一个 anyy 文件。

程序和数据分别在哪里？​

情况Home对外命令入口
普通用户默认安装$HOME/.anyy$HOME/.local/bin/anyy
root 默认安装/root/.anyy/usr/local/bin、/opt/homebrew/bin、/usr/bin 中首个可写目录
设置 ANYY_HOME你指定的目录仍按运行身份选择入口，指回该 Home

核心程序布局：

<ANYY_HOME>/
  releases/<version>/anyy
  current -> releases/<version>
  bin/anyy -> ../current/anyy
  .install/source.json
  .install/previous    # 有上一个活动版本时

安装器也准备 memory/、skills/、workspace/、secrets/、logs/、cache/、backups/ 等数据目录。准备布局时，Home 和列出的托管目录会设为 0700，包括已存在的这些目录；不会递归修改目录内所有文件。安装来源标记使用 0600。

config.yaml 来自后续配置，state.db 和 objects/ 由实际运行时按需创建。会话和个人资料不在发行压缩包里。

固定版本或更换目录​

环境变量放在管道右侧，作用于执行脚本的 sh：

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_HOME="$HOME/.local/share/anyy" sh

希望跟随最新发布时，省略 VERSION；不要写 VERSION=latest。版本必须是发布源实际提供的标签。

自定义镜像使用 ANYY_RELEASE_BASE_URL。它同时提供程序和校验文件，所以不是独立的校验机构，应只使用你控制或信任的来源。

空间不足时​

临时目录需要放下载包，Home 需要放新二进制及安全余量。优先释放对应位置的空间；接受减少回滚记录时才选：

curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh

紧凑模式保留当前活动版本，可能清理非活动版本；只有仍无法通过空间检查时，才会进一步移除上一个回滚目标。

完成安装后​

anyy setup
anyy dashboard

先用向导配置一个模型，再按 Dashboard 提示启动 Gateway。继续看快速开始或初始化设置。

同一版本已安装时，重复安装会修复入口，不重新替换该版本。日常升级使用 anyy update --check 和 anyy update，详见更新与卸载。

常见安装失败​

提示该怎么做
不支持系统或架构使用表中四个目标之一，不能拿另一架构的包强行安装
缺少命令安装输出中点名的工具后重试
空间预检失败检查报错指向临时目录还是 Home；确认可接受后再用紧凑模式
同一 Home 已有安装／更新等持锁操作结束，不并发修改版本目录
checksum 不匹配从可信源重新下载，不绕过验证
同名入口未替换先用打印的完整二进制路径，自己核对那个入口的归属
No release was activated.本次未切换到候选版本，先处理前面的具体错误