安装

这一页只解决一件事：把原生 anyy 命令可靠地安装到 macOS 或 Linux，并用 anyy --version 验收。模型、Profile 数据和常驻 Gateway 都在安装完成后再配置。

如果希望由容器管理常驻运行时，请改看使用 Docker 部署。原生 Release Layout 与 Docker 数据卷是两种安装方式，不应混成同一套实例。

原生安装支持范围

安装脚本支持 macOS、Linux，以及 amd64/x86_64、arm64/aarch64 两组处理器架构。它不提供 Windows 原生安装。

快速安装

先确认运行环境

开始前需要准备：

一台受支持的 macOS 或 Linux 设备；
可以访问 anyy.ai 的网络；
POSIX sh，以及 curl、tar、gzip、awk、sed、mktemp、readlink；
sha256sum 或 shasum 中的任意一个。

脚本会在下载发行包前检查依赖。个人用户安装在自己的目录下即可，不需要为了安装而切换到 root。

安装最新发布版

执行官方安装命令：

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

安装器会自动匹配当前系统和处理器。顺利完成时，最后会看到类似下面的结果：

Installed Anyy <version>.
Command: anyy
Gateway: <current status>

其中 Gateway: 只是在报告当前能读取到的状态，并不表示安装器已经替你配置或启动了 Gateway。

可以先阅读脚本

如果不希望直接把远程内容交给 sh，先打开 anyy.ai/install.sh，或下载后逐行检查。确认无误后再执行同一个脚本。

验收安装结果

先运行：

anyy --version

正确输出会以这段文字开头：

Anyy (anyy) version

如果安装结果显示的是 Binary:，而不是 Command: anyy，先使用 Binary: 后的完整路径执行 --version。随后按安装器给出的 PATH 指引添加对应目录，并重新打开终端。

普通非 root 用户的命令入口通常位于：

$HOME/.local/bin/anyy

安装器不会修改 Shell 启动文件；如果入口位置已经存在另一个 anyy 文件，它也不会擅自覆盖。

安装器实际做了什么

这条命令背后依次完成以下工作：

识别 darwin 或 linux，并把处理器架构映射为 amd64 或 arm64。
确定 Anyy Home 和准备安装的版本。
锁定这个 Home 的安装/更新流程，避免两个版本操作同时修改它。
检查本机命令、临时目录空间和 Home 空间。
下载对应平台的发行包与 CHECKSUMS.sha256；有限次数重试下载，且不会沿用残缺文件。
验证 SHA-256，并在安装前拒绝包含危险路径或链接的归档。
把二进制放入带版本号的目录，再原子切换 current。
写入安装来源信息；只有在不会覆盖其他文件时，才创建外部命令入口。
打印最终命令位置和当前 Gateway 状态。

安装与初始化是两步

到这里还没有选择模型服务商，也没有生成 config.yaml、state.db，更不会自动安装并启动后台服务。命令可用后，再执行 anyy setup。

文件会放在哪里

默认路径取决于由谁运行安装器：

运行身份	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
│   └── previous        # 更换过版本且存在回滚目标时才会出现
├── backups/
├── cache/
├── logs/
├── memory/
├── scripts/
├── secrets/
├── skills/
├── system/
└── workspace/

Home 和这些安装器管理的目录权限为 0700，.install/source.json 的权限为 0600。其他 Profile 与运行时文件会在后续命令真正需要时再创建。

Profile Runtime 第一次打开持久状态时，还会创建 state.db 和 Content-addressed objects/；它们属于运行数据，不是 Installer 交付的文件。

current 指向正在使用的版本，因此一次成功的安装或更新只需完成一次切换。已经有旧版本时，安装器还会记录上一个活动版本，供回滚使用。

安装参数

环境变量要写在管道右侧，作用于 sh：

变量	默认值	适用情况
`ANYY_HOME`	普通用户为 `$HOME/.anyy`，root 为 `/root/.anyy`	希望把这一套 Anyy 安装到其他目录
`VERSION`	`https://anyy.ai/releases/latest` 返回的版本	需要固定到某个已发布的 `vMAJOR.MINOR.PATCH`
`ANYY_INSTALL_COMPACT`	`0`	空间不足，并且愿意减少旧版本回滚记录
`ANYY_RELEASE_BASE_URL`	`https://anyy.ai/releases`	你维护了可信且兼容的发行镜像

改用自定义 Home

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

从安装入口启动的 Anyy 可以反推出这个常驻 Home。支持 --home PATH 的命令也可以继续显式指定路径。

固定安装版本

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.105 sh

请把示例版本换成确实存在的发布标签。不要写 VERSION=latest；希望跟随最新发布时，直接省略 VERSION。

小容量设备使用紧凑模式

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

紧凑模式会影响回滚历史

紧凑模式一定保留当前活动版本，但可能清理不再活动的旧版本；只有 Home 空间仍然不够时，它才会进一步删除上一个回滚目标。如果你希望保留完整回滚能力，优先手动释放磁盘空间。

自定义发行源等同于信任它

ANYY_RELEASE_BASE_URL 指向的服务同时提供二进制和校验文件。只应使用你自己控制或已经独立确认可信的来源。

重装与升级

如果最新版本已经处于活动状态，再运行同一条安装命令不会重新下载或替换它；安装器会检查并修复内部入口和外部命令入口。

已经采用常驻布局安装后，可以先检查是否有新版本：

anyy update --check

日常升级使用 anyy update。版本选择、紧凑更新和回滚行为将在更新页面继续说明。

安装之后

下一步运行交互式初始化：

anyy setup

完成模型配置后，打开 Dashboard：

anyy dashboard

希望从安装一路完成第一次对话，请继续阅读快速开始。服务商和模型选项会在初始化设置中单独展开。

常见问题

现象	原因	处理方式
`unsupported operating system` 或 `unsupported architecture`	当前平台没有可匹配的原生发行包	改用受支持的 macOS 或 Linux `amd64`/`arm64` 设备；此安装器不支持 Windows 原生环境
`<command> is required for release install`	本机缺少安装器依赖	安装错误中点名的命令，再重新运行安装器
`Preflight failed: not enough ... space`	临时目录或 Home 无法容纳发行包、新二进制和安全余量	释放对应空间后重试；只有接受减少回滚历史时才使用紧凑模式
`another Anyy install or update is already running`	同一个 Home 正由另一个安装或更新操作占用	等待该操作结束，再重新执行
`checksum mismatch`	下载内容与发布的校验值不一致	重新运行安装器；不要跳过验证，也不要手动激活这个归档
`Command entrypoint already exists and was not replaced`	目标命令位置已经有其他文件或仍有效的链接	暂时使用 `Binary:` 路径，并由你确认、处理冲突的同名命令
安装成功后仍提示 `anyy: command not found`	当前 `PATH` 没有包含命令入口目录	按安装器给出的准确路径修改 PATH，重开终端，再运行 `anyy --version`
`Gateway: status unavailable`	新安装的二进制暂时无法读取 Gateway 状态	先单独确认二进制可运行；完成 `anyy setup` 后，可用 `anyy gateway status` 检查常驻运行时
`No release was activated.`	安装在切换候选版本之前已经停止	查看它前面的具体错误，修复后重试；已有活动版本不会被这次失败替换

快速安装​

先确认运行环境​

安装最新发布版​

验收安装结果​

安装器实际做了什么​

文件会放在哪里​

安装参数​

改用自定义 Home​

固定安装版本​

小容量设备使用紧凑模式​

重装与升级​

安装之后​

常见问题​