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.ON.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 托管。三步上手在 Steam 商店搜索N.E.K.O.并安装免费通过 Steam 启动游戏等待首次初始化完成打开 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。首次配置三种方式通用的收尾动作无论哪种方式装好统一做两件事打开主地址的/api_key页面选择 Core / Assist 服务商填入凭证并跑连通性检查访问/health确认各服务健康。默认端口速查源码模式端口进程48911主 Web / API 服务48912记忆服务48915Agent / 工具服务48916用户插件宿主安全提醒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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
