N.E.K.O.快速部署指南：Steam/Docker/源码3种方式，5分钟拥有你的专属AI猫娘

【免费下载链接】N.E.K.OA catgirl who lives with you in real time — reaching out first, sharing your media, and actually getting things done, powered by an embodied emotional engine.🐱❤️一只会主动找你玩的 AI 猫娘。项目地址: https://gitcode.com/gh_mirrors/ne/N.E.K.O

N.E.K.O. 是一只会主动找你玩的 AI 猫娘——实时语音对话、五维记忆、多形态 Avatar、还能操作浏览器替你干活。本指南覆盖 N.E.K.O. 部署全流程：Steam 一键安装、Docker Compose 容器化、源码启动三种方式，零基础也能 5 分钟跑起你自己的专属 AI 猫娘。

部署前先看：N.E.K.O. 能做什么？

花 5 分钟部署，你得到的是：

• 💬主动陪伴：她会看你的屏幕、刷社交媒体热搜，主动找你有话聊；
• 🎙️实时语音：Realtime API 语音对话 + 实时视觉理解；
• 🧠五维记忆系统：工作 / 近期 / 事实 / 反思 / 人格记忆，越聊越懂你；
• 🎭五种 Avatar 形态：Live2D / VRM / MMD / PNGTuber / 猫咪桌宠；
• 🤖Agent 工具执行：可操作浏览器与电脑完成任务，插件商城可扩展联机游戏、直播互动等场景。

官方部署总览见 docs/deployment/index.md，各方式的适用人群一目了然。

方式一：Steam 安装（新手推荐，一键步骤）

Steam 版是官方为终端用户维护的最省心的路径：从 Steam 商店安装后直接通过 Steam 启动，在桌面 / Web UI 里配置模型服务商即可，更新由 Steam 托管。

三步上手：

1. 在 Steam 商店搜索N.E.K.O.并安装（免费）；
2. 通过 Steam 启动游戏，等待首次初始化完成；
3. 打开 Web UI 的 API Key 设置页，填入模型服务商凭证，运行连通性测试。

⚠️ 注意：Python 后端可执行文件只是"引擎"，Electron 窗口、托盘、Steam 集成和更新器都来自桌面客户端，不要只装后端包。桌面版细节见 docs/deployment/windows-exe.md。

方式二：Docker 部署（Linux / 服务器最快方案）

Docker 路径适合无桌面环境的服务器部署，由 Nginx 反代托管 Python 服务，官方维护的 Compose 文件在 docker/docker-compose.yml。

最快配置方法：

git clone https://gitcode.com/gh_mirrors/ne/N.E.K.O cd N.E.K.O/docker cp env.template .env # 按需填写 API Key 等初始化变量 docker compose up -d

然后打开http://127.0.0.1:48911即完成访问。关键点：

• 首次启动会自动生成core_config.json引导配置；想覆盖它先备份，再设置NEKO_FORCE_ENV_UPDATE；
• 数据全部落在挂载目录：./neko-home（配置、角色、记忆、插件、证书）和./logs（日志），升级前先备份；
• 容器默认时区Asia/Shanghai，可在.env里改为任意 IANA 时区；
• 健康检查：curl -f http://127.0.0.1:48911/health。

🚨 老用户升级避坑：旧版把数据拆成./N.E.K.O和./ssl两个挂载，新版合并为./neko-home。不迁移直接拉新镜像，容器会"正常"启动但数据目录是空的——角色和记忆看起来全丢了（其实只是没挂进来）。迁移脚本见 docs/deployment/docker.md。

方式三：源码部署（开发者 / 尝鲜党）

源码模式需要Python 3.11（严格锁定）、uv和 Node（^20.19.0 || >=22.12.0，供插件管理器使用）。

一键安装步骤：

git clone https://gitcode.com/gh_mirrors/ne/N.E.K.O cd N.E.K.O uv sync

接着构建前端资源（同时会校验并解包内置 Live2D 素材 Yui Lolita / Yui Origin）：

./build_frontend.sh # Windows 用 .\build_frontend.bat

然后启动：

uv run python launcher.py

启动器会规划端口、拉起 memory / main / agent 三个服务并协调关闭，浏览器打开它打印的地址即可（48911 只是首选主端口）。排查问题时可用诊断分体模式分别启动：

uv run python -m app.memory_server uv run python -m app.main_server uv run python -m app.agent_server

注意：主界面靠 memory + main 就能加载，但 Agent 工具、托管插件、浏览器 / 电脑操作能力都依赖 agent 服务。完整流程见 docs/deployment/manual.md。

首次配置：三种方式通用的收尾动作

无论哪种方式装好，统一做两件事：

1. 打开主地址的/api_key页面，选择 Core / Assist 服务商，填入凭证并跑连通性检查；
2. 访问/health确认各服务健康。

默认端口速查（源码模式）：

安全提醒：N.E.K.O. 定位是本地陪伴，入口默认绑定本机回环。若要在局域网外访问，请先想清楚认证、TLS、防火墙，以及浏览器 / 屏幕 / 记忆等能力带来的隐私影响。

部署完成，开始养猫 🐱

到这里，你的专属 AI 猫娘已经上线。接下来可以去 docs/deployment/embedding-models.md 配置本地向量检索增强记忆，或在插件商城给她装个联机游戏插件。祝你和 N.E.K.O. 相处愉快~

【免费下载链接】N.E.K.OA catgirl who lives with you in real time — reaching out first, sharing your media, and actually getting things done, powered by an embodied emotional engine.🐱❤️一只会主动找你玩的 AI 猫娘。项目地址: https://gitcode.com/gh_mirrors/ne/N.E.K.O