离开聊天窗口后,它的时间不会静止。nyairo 让 AI 拥有本地长期记忆、可编辑的虚拟小房间,以及按真实时间流动的日常。
基础安装启用记忆与生活状态;世界服务和自主生活需另外配置,自主开关默认关闭。现在这条命令装的是 v0.5.1「身体与街区日常版」(GitHub prerelease,不是稳定版);此前的 v0.4.0、v0.3.0、v0.2.0-rc3 标签与 ZIP 均保留原处。这一版整理了身体需求与休息/补给、街区早晚与物件阅读、手机日记/相册/相机入口,以及作品续作与挂起换事的接线,并修复发行与安装器一致性问题。未重跑当前整树完整套件,未做联网完整安装或 24 小时长测,升级前请先备份个人目录。更多变化见v0.5.1 更新说明与v0.4.0 版本记录。
curl -fsSL https://nyairo.com/install.sh | bash
请帮我在这台电脑上安装 NyAiro(一个可以长期相处的数字个体框架)。请按下面的步骤做,每一步都用中文告诉我你在做什么,不要跳过检查,也不要假装成功。
【背景资料】
- 官方仓库:https://github.com/L1AN929/nyairo
- 官方 Agent 安装规范:https://nyairo.com/AGENT_INSTALL.zh-CN.md(仓库里是 website/AGENT_INSTALL.zh-CN.md;如果你能读网络或仓库,先读它;读不到就按下面步骤做,本指令已经包含全部要求)
- 当前公开测试版本:v0.5.1(GitHub prerelease,不是稳定版;只使用这一个版本;不要安装其他分支、旧版本或未发布的代码)
【第一步:先检查环境,先不要安装】
请检查并用中文汇报:
1. 操作系统与架构(Linux / WSL / macOS / 原生 Windows),以及是否有 bash 和 curl;
2. Python 情况(需要 3.13;安装器会自行准备 uv 与 Python,请说明是否需要联网下载);
3. 磁盘剩余空间(建议至少 3 GB,程序与个人数据都要占空间);
4. 网络能否访问 GitHub 与 astral.sh(安装器需要下载 Python 与依赖);
5. 这个 HOME 里是否已经装过 NyAiro 或 Chiyo:检查 ~/.nyairo、~/.local/share/nyairo、~/.chiyo-v1、~/apps/nyairo-*、~/.local/bin/nyairo;
6. 现在有哪些程序在运行:pgrep -af m0_writer_worker、pgrep -af "gateway run"、pgrep -af nyairo,并看清每条命令里的路径属于哪个实例。
如果某一项不满足(例如是原生 Windows 而不是 WSL、磁盘不够、无法访问 GitHub),请先用中文解释问题和建议做法,然后停下来等我决定,不要继续安装。
【第一步补充:如果这个 HOME 里已经有实例,必须停下来做隔离】
只要第 5 项发现任何已有实例(例如 ~/.nyairo 或 ~/.chiyo-v1 已存在),就**不要在这个 HOME 里继续安装**:
- 先告诉我发现了什么(路径、大致内容、是否在运行),然后停下来等我决定;
- 推荐我换一个独立环境:优先用另一个 Linux 用户(例如 useradd 出来的专用账号,或已经存在的第二个账号)在它自己的 HOME 里安装;其次是换一个完全独立的 HOME(例如 sudo -u 专用账号 或 HOME=/home/otheruser),不要和现有实例共用同一个 ~/.nyairo 或 ~/.local/share/nyairo;
- 需要新建系统用户、需要 sudo、或需要改动现有实例时,先说明你要执行的具体命令并征得我同意,**不要擅自创建系统用户,也不要擅自使用 sudo**;
- 在我明确确认隔离方式之前,不要下载、不要解压、不要运行安装器。
关于正在运行的实例:那些进程属于**已有实例**,不是这次要装的。请只做报告,**不要终止、不要重启、不要 kill 任何已有实例的进程**(包括 m0_writer_worker 和 gateway)。安装完成后判断"有没有残留进程"时,只检查这次新装实例自己的路径(例如新 HOME 下的 ~/.nyairo),不要把已有实例的进程算进来,也不要动它们。
【第二步:说明将要改动什么,并等我确认】
这次安装会:
- 在 ~/.local/share/nyairo/releases/v0.5.1 放程序(约 460 MB,含配套 Hermes 的运行环境);
- 在 ~/.nyairo 建个人数据目录(人设、模型配置、记忆与生活状态数据);
- 在 ~/.local/bin/nyairo 放启动入口;
- 用 uv 下载一份 Python 3.13 到 ~/.local/share/uv。
如果我已经有 NyAiro 或 Chiyo 的数据,默认必须新建独立实例,不要覆盖我已有的记忆数据库、人设文件(SOUL.md)、模型配置、Telegram 绑定或正在运行的服务;确实需要改动原实例时,先停下来问我。
需要 sudo、需要覆盖已有文件、需要安装开机自启的后台服务,或需要我提供任何密钥时,都必须先得到我的同意再继续。
【第三步:安装(只用官方发行包,并且校验)】
1) 下载官方发行包与校验值:
curl -fsSL -O https://github.com/L1AN929/nyairo/releases/download/v0.5.1/nyairo-v0.5.1.zip
curl -fsSL -O https://github.com/L1AN929/nyairo/releases/download/v0.5.1/nyairo-v0.5.1.zip.sha256
sha256sum -c nyairo-v0.5.1.zip.sha256
ZIP 的 SHA256 必须与同一发行页下载到的 nyairo-v0.5.1.zip.sha256 记录一致;这一页不再抄写固定哈希,以你实际下载到的校验文件为准。
不一致就立刻停止,把实际值告诉我,不要继续。
2) 解压并使用包内的官方安装器安装(不要自己另写一套安装脚本):
python3 -m zipfile -e nyairo-v0.5.1.zip "$HOME/apps/nyairo-v0.5.1"
cd "$HOME/apps/nyairo-v0.5.1" && bash scripts/bootstrap.sh
如果你的终端无法交互(没有 TTY),改用:bash scripts/bootstrap.sh --no-setup --no-launch
装完再单独引导我配置模型:~/.local/bin/nyairo setup model
【第四步:装完必须实际验证,不要只看命令有没有报错】
- 版本:读 ~/.local/state/nyairo/install.json 里的 version 字段,应该是 v0.5.1;也可以用 ls ~/.local/share/nyairo/releases/ 确认目录名是 v0.5.1。
(注意:nyairo --version 显示的是配套 Hermes 的版本,不是 nyairo 的版本。)
- 完整性:用包内解释器校验清单:
~/.local/share/nyairo/releases/v0.5.1/vendor/hermes/.venv/bin/python -B ~/.local/share/nyairo/releases/v0.5.1/scripts/verify_manifest.py
输出里应该有 "valid": true。
- 个人数据目录:~/.nyairo 下应该有 SOUL.md、config.yaml、chiyo/config.json。
- 启动:~/.local/bin/nyairo --help 能正常输出帮助。
- 启停与残留:跑一次一次性自检 ~/.local/bin/nyairo -z "安装自检";随后只检查这次新装实例自己的路径:pgrep -af m0_writer_worker(按命令行里的新 HOME 过滤)不应该留下属于它的进程,~/.nyairo/chiyo/state/memory/m0-writer-runtime/ 不应该留下 socket 文件。已有实例的进程不要动,也不要算作残留。
- 模型与 Telegram:在我没有提供自己的密钥之前,这两项属于「尚未验证」,请如实说明,不要报告为成功。
【第五步:最后给我一份中文说明】
用简单的中文告诉我:安装是否成功、装在哪里、怎么启动(nyairo)、怎么配置模型(nyairo setup model)、怎么接 Telegram(nyairo gateway setup 然后 nyairo gateway run)、怎么停止(退出聊天,或在网关终端按 Ctrl-C)、怎么更新(~/.local/bin/nyairo update,可加 --check 先看有没有新版)、怎么备份(退出聊天和网关后 tar -czf "$HOME/nyairo-backup-$(date +%Y%m%d-%H%M%S).tar.gz" -C "$HOME" .nyairo)、怎么卸载(先备份 ~/.nyairo,再删除程序目录 ~/.local/share/nyairo/releases/v0.5.1 与入口 ~/.local/bin/nyairo;如需彻底清除再自行删除 ~/.nyairo)。不要只贴终端日志。
【安全要求】
- 不要擅自创建系统用户,也不要擅自使用 sudo;需要时先说明你要执行的命令并征得我同意。
- 不要终止、重启或强杀我已有实例的进程(m0_writer_worker、网关、聊天进程都不要动)。
- 不要让我把 SSH 密码、私钥或 API Key 粘贴到聊天里。密钥由我自己在本地输入:~/.local/bin/nyairo setup model 与 ~/.local/bin/nyairo gateway setup。
- 不要读取其他实例的密钥,不要把密钥发到外部服务,不要写进日志,不要提交到 Git。
- 如果你没有终端或 SSH 权限,请直接说明你做不到,并告诉我怎样授权;不要假装安装成功。看一看它在真实场景里是怎么跟你相处的:拥有属于自己的空间与生活节律,记住你说过的事,也能随时协助你处理事务。
从单次问答工具,走向有生活、有记忆、能帮你写代码的数字伙伴。
跨会话召回重要经历,可查看、纠正用户记忆或停止召回。数据库本地保存;遗忘不等于擦除原始聊天和备份。
查看记忆用法 →拥有属于自己的日常状态流。关掉窗口或重启电脑后状态不丢,保持独立节律与连续性。
查看状态流转 →在虚拟空间里拥有具体位置与姿态,感知光线与环境变化,让日常每一次交流身临其境。
探索世界感知 →显式提交问题,获得有界的 Shadow 分析与建议。判断不会切换模式、执行动作或发送消息。
查看认知用法 →从最初的本地记忆和查代码,到拥有自己的房间、真实走路与自发生活。这里记录我们正在做和接下来想做的事。
重要记录保存在本地 SQLite,关机重启后经历不丢。平时是聊天伙伴,写代码卡壳时敲命令切成 Agent 帮你排查。
聊天记录和记忆存放在自己电脑本地数据库,说错了随时纠正,不上传云端。
生活状态独立守护,重新打开电脑后继续聊,不是用完就扔的单次窗口。
输入命令即可让它进入工程模式,帮你推演系统风险、生成自动化脚本。
自带网页地图编辑器,可以画房间、摆家具;出门去便利店真的要在路上走几分钟;就算关掉聊天界面,它在后台也有自己的生活。
包里自带轻量可视化编辑器,可画墙、放门、摆桌椅,也支持现成城镇模板。
去便利店走 5 分钟,去公园走 9 分钟;在途问它走到哪了,它如实说在路上。
关掉聊天窗口,它在后台按节律自己散步、写日记。长测中曾自发写出千字随笔。
0.2 已经能自主做一些事;0.3 把出门、等待、改主意、消费、留下经历、回家续自己的事,接成可以暂停、可以恢复的连续过程。这一版已作为 GitHub prerelease 发行,按机制限定的验收 51 项通过、0 跳过。
从活动世界图解析动态地点与室内入口,歧义或不可达直接拒绝,不再依赖硬编码中转。
行程记录目标、段与进度;暂停只挡新的一段,已出发的一段如实走完,恢复不会重走已走的路。
六个地点的街区里散步、停留、消费;吃到的一份原子耗尽并留下回执;经历经准入影响下一步选择。
v0.3.0 曾作为 GitHub prerelease 发行,官网安装命令与可校验 ZIP 当时都指向这一版;现在发行位已交给 v0.5.1,v0.3.0 的标签与 ZIP 保留原处。验收仍是机制限定的——本地真实 owner 加确定性/loopback 替身与显式时钟,没有真实模型跑一整天、没有 24 小时长测、不是生产部署验收。 v0.3 对比 v0.2 · 限定验收报告
0.3 让出门、等待、回来能接上;0.4 把「一天里连着过」补完:一段旅程拆成多段各自消费,暂停可以同时挂起好几件事,世界里的天气与事故能跨天延续。
出门拆成多段,每段独立消费与记账;实测跑通 卧室 → 客厅 → 街上 → 书店 的连续四段。
暂停释放前台并留下显式等待条件,可以同时挂起好几件事;条件满足后回到候选,任何时刻只有一件在执行。
环境事件分三档,跨天事件有固定身份、有阶段、到期不复活;出门遇到的事会影响之后的合法选择。
v0.4.0 曾作为 GitHub prerelease 发行,当时官网安装命令和可校验 ZIP 都指向这一版;现在发行位已交给 v0.5.1,v0.4.0、v0.3.0 与 v0.2.0-rc3 的标签与 ZIP 保留原处。这一版当时记录 world 套件 263 例全绿,仍有两处更早就存在的红未修;没有真实模型跑满一天、没有 24 小时长测,也未对现有实例做生产升级。明确还没做:统一 Web 生活与模型配置台、主动发信与拨打电话、天气联动、到点自动想起(Agenda 接线)、营养/饥饿与完整情绪、193 项全部能力——这些都留在后续版本,不要当成已经实现。 v0.4.0 发行页
0.5.1 把这一阶段做过的内容整理进公开测试版:身体有了需求与休息、补给节奏,街区有了早晚变化和更多可读的物件,手机里多了日记、相册和相机,作品也能接着做下去。
身体开始按真实经过的时间记录需求、休息与补给,动作会产生后果;这不是完整的营养、饥饿或健康系统。
同一段街区在不同时段有不同的样子,路边物件和阅读角能提供可读的内容,不再永远是同一张静态背景。
新增日记、相册和相机入口,可以在手机界面保存照片、翻看相册、写当天的事;作品续作与暂停换事的接线也已接上。
v0.5.1 作为 GitHub prerelease 发行:官网安装命令和可校验 ZIP 都指向这一版,v0.4.0、v0.3.0 与 v0.2.0-rc3 的标签与 ZIP 保留原处。发布前做了分段测试、9 条新增脱敏离线测试、归档清单、ZIP 校验、独立解包和安装器帮助检查;没有重跑当前整树完整套件,没有做联网完整安装或 24 小时长测。G1 整体、G2 历史选择比较和完整 V-C 仍未通过;删除相关的恢复只做到已验证的有限保护,完整跨备份保护尚未完成。 v0.5.1 发行页 · v0.5.1 更新说明
换了新电脑、新系统甚至换底层大模型,它的记忆、房间布置、日记和你们过去的经历都能完整打包迁移,不用从头再来。
一键完整打包房间状态、日记手记和记忆数据库,换电脑一键导入复原。
记忆与人设不绑定在特定的模型权重上,未来换用任意顶尖大模型,依然是同一个它。
在日复一日的交流中沉淀出专属的说话习惯,成为真正懂你、习惯你节奏的数字伙伴。
引导安装 → 配置模型 → 检查第一句回复。世界、资源服务与自主生活按教程另行配置。