4.4. naia-offline

Naia 是一个建立在"在自己的电脑上拥有自己的 AI"理念之上的开源项目。 你无需把对话交给大厂云端，而是下载模型并直接在自己的 GPU 上运行。模型不局限于 Naia OS（外壳）——它可以通过 OpenAI 兼容 API 通用使用：只需更改端点，任何 OpenAI SDK、工具或应用都能工作，你还可以在其之上构建新应用。Naia 模型的使用许可面向个人订阅者提供（企业 / 多席位 → 联系我们），并通过订阅密钥激活。订阅费用用于改进 Naia 开源项目以及运营服务。

• 所有权 — 模型驻留在你的设备上。在订阅期间，即使没有网络也能继续工作。
• 隐私 — 语音和对话在本地处理，绝不离开你的机器。
• 统一费率 — 无按 token 或按小时计费：$10 / month（个人）。收入用于 Naia 开源项目的运营与改进。
• 自由使用 — 不局限于 naia-os（外壳）。它公开了 OpenAI 兼容 API，因此只需更改端点，任何 OpenAI SDK / 工具 / 应用都能连接，你还可以在其之上构建新应用。（开发者细节 → 4.5 模型详情（开发者））
• 安全性 — 模型性能强大，存在被用于语音钓鱼等滥用的风险，因此我们采用语音水印技术以具备可追溯性，让你放心使用。

你将下载的模型是 naia-0.9-omni-24g（多语言实时语音对话）。请先试试 30 秒的 免费演示。如果你没有 GPU，在 GPU 资源池扩展后还将提供 在线使用（4.6）。

推荐配置：一块 24GB 显存的 GPU（RTX 3090 / 4090 等）。前置条件：NVIDIA 驱动 + podman（或 docker）+ nvidia-container-toolkit（CDI），约 30GB 可用磁盘空间。

请从下方开始 — ① 下载 → ② 发行订阅密钥并运行 → ③ 释放与重装（切换设备）。

从 naia-os（或任意应用）连接

将 naia-os 的网关 / 后端 URL 指向正在运行的容器。只需给出基础 URL——路径（/v1/realtime）和默认模型会自动应用：

• 同一台 PC：ws://127.0.0.1:8892 — 本地连接，直接使用明文即可。
• 另一台设备（远程）：经由 TLS 入口连接（见下方 Tailscale）。当你给出主机名时，naia-os 为了安全会自动以加密（wss）方式连接，但容器的 8892 是明文（ws），所以直接用 TLS 连到 8892 会失败（SSL / Websocket 错误）。因此远程要使用在前端加了 TLS 的地址（例如 https://<主机>:8443）。

订阅密钥只在运行（激活）时使用一次（用于订阅检查和许可证发行）。一旦激活，容器会以许可证在本地自我校验，因此像 naia-os 这样的客户端只需用上面的 URL 连接即可——同一台 PC 用 127.0.0.1（明文），其他设备用下方的 Tailscale（TLS）。没有单独的连接密钥。

从代码使用它（OpenAI 兼容的 chat / TTS / STT / embeddings / realtime API）→ 请参阅 4.5 模型详情（开发者）。

远程访问 — Tailscale（推荐）

从另一台笔记本 / 手机上的 naia-os 安全访问你家中 GPU 的最简单方式：

1. 在两台设备上都安装 Tailscale，并用同一个账户登录。
2. 在 GPU PC 上设置一次 TLS 入口（tailscale 会自动签发并终结证书）：
   Copy

   tailscale serve --bg --https=8443 http://127.0.0.1:8892
   

3. 把 naia-os 的后端 URL 设置为 https://<机器名>.<tailnet>.ts.net:8443（路径与模型自动）。机器地址可用 tailscale status 查询。

这样 tailscale 会接收 TLS 并转发到明文的 8892，因此 naia-os 的加密（wss）连接可以正常工作。无需端口转发或公网 IP，在家或在外都可使用。

⚠️ ws://<tailscale-ip>:8892 直连在 naia-os 中不可用 — 因为 naia-os 会以 wss（TLS）方式连接主机名，而 8892 是明文。请使用上面的 --https 入口（:8443）。（若是只用明文 ws 的自有代码，则也可直连 tailnet IP。）

其他远程选项（替代方案）

包装层是纯 ws。当把它暴露到公共网络时，务必在前面加上隧道 / VPN 的 TLS + 认证。Tailscale / WireGuard / SSH 本身即已加密。

许可证详情

• 有效期 = 订阅期 — 许可证在订阅期内有效。在此期间离线运行，仅在续订时需要联网。到期后容器会自动关闭 — 续订并重新激活（步骤 2）即可继续使用。
• 1 个订阅 = 1 台活动设备 — 同一时刻只有一台设备处于活动状态，并且当一台设备处于活动状态时，你无法发行新的订阅密钥（通常只有一个密钥）。
• 切换设备 = 释放（上面的步骤 3）+ 在新设备上重新激活 — 在旧设备的容器中释放会自动上报到服务器并释放活动设备。然后在新设备上再次发行并运行（步骤 2）。仅释放只是腾出名额。
• 不释放就删除容器并不会释放活动设备 — 如果你用 podman rm 删除容器（或丢失设备），释放不会上报到服务器，因此活动设备仍然保留，并且在订阅期结束前会阻止新的激活（到期时自动释放）。删除容器前请务必先执行步骤 3 的释放。
• 停止自动续订（网页） — 在网页上禁用某个订阅密钥的续订不会立即使其失效；它会停止续订，因此活动设备会在订阅期结束时脱离（在那之前无法重新发行）。要立即释放活动设备，请使用容器释放。仅在密钥泄露时使用。
• 个人订阅可用于将你自己的创作变现（例如 VTubing）。企业 / 多席位 / 自助终端 / 展览 / 转售 / 产品嵌入须另行协议。
• 生成的音频会嵌入识别水印 — 输出语音中刻有可追溯的识别信号，因此一旦被用于冒充、未经同意的语音合成、深度伪造或诈骗等滥用行为，可追溯其来源。此类非法或欺骗性使用被禁止，一经发现可能导致订阅终止并承担法律责任。

更换对话模型（自 0.91 起）

naia 默认内置了一个用于对话的 AI。从 0.91 起，你可以把这个对话用 AI 换成别的。语音（说与听）和订阅保持不变，只更换负责对话的那部分。

• 默认对话模型是内置的开源 LLM。 它轻量且能处理多种语言。你可以随时换成别的，也可以随时恢复默认。
• 太大的模型无法加载。 即使显卡有 24GB，说与听的功能也始终占用约 10GB。因此新加载的对话用 AI 大约以 14GB 为上限。比这更大的不会被应用。
• 即使出错，对话也不会中断。 加载新模型失败时，会自动回退到原先使用的模型。
• 个人订阅者无需额外获取任何东西。 仅凭本人的订阅即可更换。

自行更换的具体方法见 开发者指南。我们正在准备让你在界面上选择模型并点击即可完成更换的功能。

更新到新版本（自 0.91 起）

有新版本发布时，只需重新拉取镜像并再次启动即可。订阅、设备注册、默认模型和语音设置都会保持不变，无需重新认证。（新版本首次运行时会通过网络自动重新认证，因此更新时需要联网。）

# 1) 拉取最新版本
podman pull ghcr.io/nextain/naia-0.9-omni-24g:latest

# 2) 只清理容器（许可证卷保持不变）
podman stop naia-omni && podman rm naia-omni

# 3) 原样重新执行首次安装时所用的运行命令
#    （挂载同一个许可证卷即可保持订阅与设备认证）

• 若要指定特定版本，请用 :0.91 这样的版本号代替 :latest。如果新版本有问题，可以用同样的方式拉取旧版本标签来回退。
• ⚠️ 不要为了更新而点击"释放设备"。 释放设备只在把当前电脑更换为另一台电脑时使用。更新时误点会导致你必须从头重新认证。只要保持许可证卷不变，无需释放即可更新。

即将推出的模型

• naia-0.9-coding-24g（24GB，编码 / 智能体）— 计划中
• naia-0.9-omni-48g（48GB，更大的 omni）— 计划中
• Naia-OS 捆绑扩展 — 计划作为可直接接入 naia-os 应用的离线扩展。它将自动检测你的 GPU，选择匹配的模型（层级），一步完成下载和安装（无需命令行）。

全部将以相同的 $10 / month 订阅（个人）提供。B2B 采用须另行协议。