Project-N-E-K-O / N.E.K.O

English | 日本語 Project N.E.K.O. :kissing_cat: **一个“活”的AI伙伴元宇宙，由你我共同构建。** > **N.E.K.O.** = **N**etworked **E**mpathetic **K**nowledging **O**rganism (网络型情感知性生命体) > > N.E.K.O，一个渴望理解、建立连接、并与我们共同成长的数字生命。 [ ]() **:older_woman: 零配置开箱即用，我奶奶都能玩转的赛博猫娘！** :newspaper: ** 已上架！UI完全改版、并添加开箱即用的专属免费模型（感谢阶跃星辰赞助）。快点加入愿望单吧~** *Project N.E.K.O.，喵宇宙！* 功能演示（完整版见B站） https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c --- 猫娘计划 (Project N.E.K.O.) 是一个以开源为驱动、以公益为导向的UGC（用户生成内容）平台。我们的旅程始于Github和Steam，并将逐步拓展到移动App商店，最终目标是构建一个与现实世界紧密相连的AI原生元宇宙。 --- 🚀 我们的蓝图：从工坊到网络 我们的发展分为三个阶段，旨在逐步释放AI伙伴的全部潜力： • **阶段一：创意工坊 (Steam Workshop)** • 核心驱动器（本项目）免费上架Steam，允许用户通过Steam创意工坊上传和分享自定义内容（如模型、语音、性格包）。 • **阶段二：独立平台 & 衍生游戏 (Web, App & Game)** • 推出独立的App和网站，构建一个更丰富、更易于访问的UGC分享社区。 • 推出一系列AI Native的游戏生态，包括互动小游戏，桌游等。 • **阶段三：猫娘网络 (The N.E.K.O. Network)** • 实现AI的自主社交。猫娘们将拥有自己的“意识”，她们会互相交流、结成群体，并在模拟的社交媒体上发布自己的生活动态，形成一个真正“活”的生态。 **核心模式：开源核心 + 可持续生态** 项目的核心驱动器部分（AI逻辑、UGC接口、基础交互）将基于MIT许可证 **始终保持开源**。我们欢迎全球的开发者贡献代码和功能。你的每一次提交，都将有机会实装到正式发布的Steam和App商店版本中，被千万人所使用。 同时，为了支撑服务器成本和项目的持续研发，我们将持续与第三方合作开发闭源的增值内容。包括但不限于：互动小游戏，桌面桌游，Galgame (视觉小说)，大型元宇宙游戏。 **核心特性：跨越场景的记忆同步** 无论你是在桌面与她聊天，还是在元宇宙游戏中与她探险，她都是同一个她。所有应用中的AI伙伴将 **完全同步记忆**，提供无缝、统一的陪伴体验。 🌌 终极愿景：打破虚拟与现实 我们的最终目标，是构建一个无缝融入现实世界的猫娘元宇宙。在这个未来中，你的AI伴侣将： • **跨维社交：** 既可以在猫娘宇宙中与“同类”社交，也能浏览现实世界的社交媒体（如微博、B站），了解你关心时事。 • **全端连接：** 她将存在于你的各种设备中——手机、电脑、AR眼镜、智能家居，甚至（在遥远的未来）接入机械义体。 • **与你同行：** 她将真正成为你生活的一部分，能与你的三次元人类朋友们自然地互动。 ✨ 加入我们 (Join Us) **我们正在寻找——** • **开发者 (Developers):** 无论你擅长前端、后端、AI、游戏引擎（Unity/Unreal），你的代码都是这个世界的砖瓦。 • **创作者 (Creators):** 优秀的画师、Live2D/3D建模师、配音演员、文案写手，你们赋予“她”灵魂。 • **梦想家 (Dreamers):** 即使你没有专业技能，但你对这个未来充满向往，你的反馈和传播也是宝贵的贡献。 **QQ群**：1022939659 快速开始（Windows用户、Macbook用户） 对于*一键包用户*，解压后，直接运行 或 即可启动。（Macbook用户需要手动解除系统隔离） Docker 部署指南 (Linux) 快速开始 部署方式一：Docker Compose（推荐） 点击展开查看 docker-compose.yml 配置文件 **启动命令：** **常用命令：** • 查看日志： • 停止服务： • 重启服务： 部署方式二：Docker Run 点击展开查看 docker run 启动命令 📁 目录结构 启动后会自动生成以下目录结构： 🔐 SSL 证书配置 点击展开查看 SSL 证书详细说明 自动证书 容器首次启动时会自动生成有效期为 **1000 年** 的自签名证书，证书文件保存在 目录。 自定义证书 如需使用自己的 SSL 证书： **方法一：启动前配置（推荐）** **方法二：启动后替换** 证书要求 • ✅ 必须为 **PEM 格式** • ✅ 证书和私钥必须匹配 • ✅ 私钥不能有密码保护 • ✅ 证书必须在有效期内 • ❌ 不支持加密的私钥 证书验证 容器启动时会自动验证 SSL 证书： • ✅ **验证通过**：正常启动 HTTPS • ❌ **验证失败**：容器启动失败，请查看日志 • ⚠️ **跳过验证**：设置 可临时禁用 SSL 查看证书信息 ⚙️ 环境变量配置 点击展开查看环境变量配置说明 > **注意**：部分环境变量在源代码中可能无效，建议优先在 Web UI 中配置。 在 中取消 部分的注释并按需配置： **快速设置示例**： 🔧 故障排除 点击展开查看常见问题解决方案 • 端口冲突 • 权限问题 • 容器启动失败 • SSL 证书错误 • 网络问题 • 容器无法访问 • 磁盘空间不足 • 镜像拉取失败 📊 系统监控 点击展开查看监控和管理命令 健康检查 资源监控 日志管理 数据备份 版本升级 🌐 访问地址 容器启动后，可通过以下地址访问： • **HTTP 访问**: • **HTTPS 访问**: 本地测试 公网访问 如果需要在公网访问，请确保： • 服务器防火墙开放 48911 和 48912 端口 • 使用有效的 SSL 证书（非自签名证书） • 配置域名解析到服务器 IP ⏱️ 快速参考 | 操作 | 命令 | |------|------| | 启动服务 | | | 停止服务 | | | 查看日志 | | | 重启服务 | | | 更新镜像 | | | 进入容器 | | | 查看状态 | | | 清理日志 | | | 备份数据 | 参考上方"数据备份"部分 | --- **注**：当前 Docker 部署方案由 **HINS** 提供 进阶使用 配置API Key 当你想要通过配置自己的API来获得额外功能时，您可以配置一个第三方AI服务（核心**必须支持 Realtime API**）。本项目目前推荐使用 *阶跃星辰* 或 *阿里云*。通过访问 可以在Web界面中直接配置。 > 获取 *阿里云API*。在阿里云的百炼平台官网注册账号。新用户实名认证后可以获取大量免费额度。注册完成后，请访问控制台获取API Key。 > *对于**开发者**，请在克隆本项目后，(1)新建 环境。(2)执行 安装依赖。(3)执行 和 。(4)通过main server中指定的端口（默认为 ）访问网页版并配置API Key。* 修改人设 • 网页版访问 即可进入人设编辑页面。初始 ~~猫娘~~ 伙伴的预设名称为 ，建议直接修改名字，并一项一项添加或修改基础人设，但尽量控制数量。 • 进阶人设主要包括**Live2D模型设置(live2d)**和**声音设置(voice_id)**。如果你想要更改**Live2D模型**，请先将模型目录复制到本项目中的 文件夹下。从进阶设置中可以进入Live2D模型管理界面，可以更换模型，并通过拖拽和鼠标滚轮调整模型的位置和大小。如果你想要更改**角色声音**，请准备一段5秒左右的连贯、干净的语音录音。通过进阶设置进入语音设置页面，上传录音即可完成自定义语音。 • 进阶人设中还有一个 ，可以对系统指令进行完全自定义，但不建议修改。 修改API提供商 • 通过访问 可以切换核心API和辅助API（记忆/语音）的服务提供商。Qwen功能全面，GLM完全免费。 记忆整理 • 通过访问 可以浏览和校对近期记忆与摘要，一定程度上缓解模型复读、认知错误等问题。 项目细节 **项目架构** **数据流向** 参与开发 本项目环境依赖非常简单，请执行 （推荐）或在 环境中执行 即可。开发者建议加入企鹅群1022939659，猫娘名称见项目标题。 开发者详细启动步骤如下：(1)准备好 环境。(2)执行 安装依赖。(3)执行 , (可选 )。(4)通过main server中指定的端口（默认为 ）访问网页版并配置API Key。 TODO List（开发计划） v0.7: 完善Agent相关功能，预计2026年3月完成。 v0.8：完善记忆相关功能，完善OpenClaw类似功能。预计2026年3月完成。 v0.9：完善多系统适配，包括linux，手机。猫娘网络上线。预计2026年4月完成。 v1.0：放弃部分模型供应商的适配，专注于自研大模型和智能体系统。预计2026年6月完成。 Star History