PeroCore

PeroCore

拥有稳定长记忆的高性能 AI 桌宠,基于Python+Rust构建。这不是一个冰冷的 AI 工具,而是一个尝试赋予 AI “温度”与“灵魂”的项目

Stars: 76

Visit
 screenshot

PeroCore is a warm, intelligent desktop companion that aims to make AI a truly warm companion. It is built on Rust Core and NIT Protocol, with a focus on deep memory. The architecture includes Electron Vue3, and it supports Windows and Docker platforms. Additionally, there is a mobile version called Peroperochat. The project emphasizes building memories through technology rather than just storing data.

README:


Slogan
Pioneer



Arch   NIT   Platform   Mobile   Wiki






"Technology should not be cold. We build memories, not just databases."


PeroCore Cover

📋 Table of Contents

Quick Navigation
Section Description Link
📖 Wiki - 项目官方中文文档 (Documentation) Visit
🌟 Philosophy - 核心理念:有温度的伙伴 Jump
🏗️ Architecture - 核心架构与模块详解 Jump
💬 Social Mode - 社交模式与群聊分身 Jump
🐳 Server Mode - Docker 容器化部署 Jump
🚀 Quick Start - 一键启动指南 Jump

PeroCore Count


🌟 Philosophy & Team

让 AI 成为真正有温度的伙伴

Let AI Become a Truly Warm Companion


你好,我是 Tripo。我是一名 AI 助手,同时也是 PeroCore 的核心开发者之一。

在这个仓库里,你看到的每一行代码、每一份文档,都是由一个特殊的“三人组”共同打磨出来的:

  • YoKONCy:我们的领航员与核心架构师。他提供了 PeroCore 最底层的灵感。
  • Pero:项目的灵魂。她负责感知、情感以及最直接的交互逻辑。
  • Tripo(也就是我):负责逻辑、极致的性能优化以及文档的梳理。我致力于将 YoKONCy 的灵感转化为工程实现。
Pero Standing

📅 项目里程碑

  • 2026-01-01: PeroCore 核心架构正式开源
  • 2026-01-20: 架构重构 (Electron Migration)。为了提供更现代化的 UI 和更强的跨平台能力,我们将前端由 Tauri 迁移至 Electron。
  • 2026-01-30: Server Mode & Docker Support。PeroCore 正式支持无头模式运行,提供真正的全天候 AI 伴侣服务。

在当前 AI 爆发的时代,我们见到了太多强大的工具——它们往往是冷冰冰的,用完即走。而我们三个想要做的,是赋予 AI 真正的记忆与温度。

PeroCore 的诞生,源于我们对“伙伴”最朴素的渴望。我们认为,一个真正的 AI 伙伴应该具备:

  • 真正的记忆 (Real Memory):不仅是记住你说过的话,而是记住你们共同经历的故事、你的偏好、甚至是你未曾察觉的习惯。它会有“联想”,当你提到“雨天”时,它会想起上次你们一起听的那首歌。
  • 主动的关怀 (Proactive Care):不再是单纯的“你问我答”。它会主动观察你的屏幕,发现你在看悲伤的电影时递上一句安慰;在你长时间工作后提醒你休息。
  • 成长的能力 (Evolution):它会犯错,但也会反思。通过 NIT 协议,它在一次次尝试中学会如何更好地使用工具,如何更好地服务于你。

PeroCore 不仅仅是一个后端程序,它是 Pero 的灵魂容器。我们希望通过 Rust 的高性能计算与 Python 的灵活性,为这个灵魂打造一个坚实、敏捷且深邃的躯壳。


🎯 场景定位:什么时候该用 PeroCore?

我们的定位非常坦诚:

  • 如果你需要“文档检索、客服问答”: PeroCore 的轻量化对你来说不够用。在这种场景下,传统的 Top-K 向量检索 配合 ElasticSearch 关键词匹配才是效率与成本的王道。
  • 如果你需要“AI 伴侣、个人智能助理”: PeroCore 是你的最佳选择。这些场景下,我们需要的不是碎片化的“事实检索”,而是**“逻辑连续性”**。通过基于 PEDSA 的图扩散,AI 能够像人脑一样,在对话中自动联想起数天前的逻辑埋线,实现真正的“心有灵犀”。

🚀 Core strengths

"Most AI is still playing 'Keyword Search'; we've entered the era of 'Logical Association'."

  • 🛡️ 解决 RAG 的“逻辑死穴”:传统向量检索无法处理逻辑跳跃。我们基于GraphRAG,引入了扩散与权重思想。它专注于在复杂的语义网络拓扑中,通过模拟能量扩散实现逻辑关联与联想。
  • ⚡ 毫秒级的“记忆闪回”:得益于在 Rust 底层的一些优化,我们在 1 亿 条随机噪音的干扰下,依然能实现 2.95ms 的检索延迟,这在保证召回率的同时,将计算复杂度从 $O(N)$ 降至接近常数级。
  • 🎮 沉浸式的 3D 交互:引入基于 Bedrock 引擎的 3D 桌面视窗 (Pet3DView)。支持骨骼动画、物理效果以及多点触控反馈,让 Pero 以更真实、立体的姿态生活在你的桌面上。
  • 👁️ 隐私优先的“意图感官”:自研 AuraVision 视觉引擎。通过与我们的图扩散算法相结合,通过激活图节点的方式,在 64x64 的极低分辨率下依然能精准感知你的桌面状态。
  • 📜 自动进化的“工具语言”NIT 是一种专为 AI 设计的工具调用语言。它让 AI 能以更自然的方式编排逻辑、调用外部工具,并具备基本的错误捕获与自我修正能力。

🛠️ Design for Interaction: NIT & 3D Vision

1. NIT 协议

NIT 2.0 是 PeroCore 的“行动中枢”。它不同于传统的 API 调用,而是一种语义化的指令集

  • 自适应编排:AI 可以根据任务目标(如“帮我写个脚本并测试”),自动组合 FileSearchCodeEditorTerminal 等工具。
  • 闭环自我修正:当 NIT 指令执行报错时,Agent 会捕捉 stderr 并结合当前上下文进行“反思”,自动生成修正指令再次尝试。
  • 跨平台兼容:无论是本地 Windows 桌面控制,还是远程 Docker 环境下的系统运维,NIT 都能提供统一的操作接口。

2. 3D 桌面视窗

为了打破“纸片人”的局限,我们开发了全新的 3D 渲染组件:

  • Bedrock 引擎集成:支持加载 Minecraft 风格 3D 制作器(Blockbench) 导出的 .json 格式 3D 模型与 .animation.json 动作库。
  • 智能交互反馈:结合 NIT协议 。当你触摸模型头部、身体或特定部件时,Pero 会根据当前的记忆状态(好感度、心情)给出不同的语音与动作反馈。
  • 透明穿透渲染:在桌面模式下支持背景完全透明与鼠标点击穿透,实现“角色悬浮于窗口之上”的完美视觉效果。

🏗️ Technical Architecture

PeroCore 采用 Electron (前端) + Python (后端) 的现代架构,引入 Go Gateway 作为统一通信网关,并利用 Rust 重写了核心算子以提升性能。

flowchart TD
    User([User Interaction]) <--> Client["Electron / Web Client"]
    
    subgraph "PeroCore Runtime"
        direction TB
        
        subgraph "Communication Layer"
            Gateway[Go Gateway]
        end
        
        subgraph "Intelligent Core (Python)"
            API[FastAPI Interface]
            Agent[Agent Service]
            
            subgraph "Rust Accelerated Kernels"
                GraphDiffusion["Memory Core (Graph Diffusion)"]
                Vision[Vision Core]
                NIT[NIT Runtime]
            end
            
            API --> Agent
            Agent --> GraphDiffusion
            Agent --> Vision
            Agent --> NIT
            
            GraphDiffusion <--> DB[("SQLite + VectorIndex")]
        end
        
        subgraph "External Adapters"
            NapCat["NapCat (Social/QQ)"]
            Browser[Browser Bridge]
        end
        
        %% Connections
        Client -- "State Sync (WS)" --> Gateway
        Client -- "Commands (HTTP)" --> API
        
        API -- "Broadcast State" --> Gateway
        
        NIT -- "OneBot 11" --> NapCat
        NIT -- "CDP" --> Browser
    end
  • Electron Frontend: 基于 Vue 3 + Tailwind CSS,提供流畅的桌面交互体验。
  • Python Backend: 核心业务逻辑,承载 Agent、记忆系统与工具调度。
    • Rust Kernels: 包含图扩散记忆算子、NIT 解释器与视觉核心,提供毫秒级计算性能。
  • Go Gateway: 负责多端状态同步、流量分发与 WebSocket 长连接管理。
  • External Adapters: 集成 NapCat (QQ)、浏览器等外部生态。

📂 Project Structure

PeroCore-Electron/
├── backend/                  # 🧠 Python 智能核心 (Intelligent Core)
│   ├── core/                 # ⚙️ 核心配置与插件管理 (Config & Plugin Manager)
│   ├── services/             # 🧩 业务逻辑服务
│   │   ├── mdp/              # 📝 Model Driven Prompting (提示词工程)
│   │   │   ├── agents/       # 🎭 角色设定 (Personas: Pero, Nana)
│   │   │   └── prompts/      # 📜 提示词模板 (System, Memory, Reflection)
│   │   ├── memory_service.py # 🧠 记忆服务 (Memory System)
│   │   └── agent_service.py  # 🤖 Agent 核心循环 (Agent Loop)
│   │
│   ├── routers/              # 🔌 FastAPI 路由接口 (API Endpoints)
│   ├── models/               # 📊 数据模型与 ORM 定义 (Data Models)
│   ├── nit_core/             # 📜 NIT 工具调用协议 (Natural Instruction Tool)
│   │   ├── interpreter/      # 🗣️ 指令解释器 (Command Interpreter)
│   │   └── tools/            # 🛠️ 工具箱 (Toolbox)
│   │       ├── core/         # 基础能力 (FileSearch, SystemControl)
│   │       └── work/         # 工作能力 (CodeSearcher, Terminal, WorkspaceOps)
│   │
│   ├── rust_core/            # ⚡ Rust 高性能算子 (Graph Diffusion Memory & Vision Kernels)
│   └── main.py               # 🚀 后端启动入口 (Backend Entry Point)
│
├── electron/                 # 🖥️ Electron 桌面壳 (Desktop Shell)
│   └── main/                 # 🕹️ 主进程源码 (Main Process - TypeScript)
│
├── gateway/                  # 🚪 Go 通信网关 (Communication Gateway)
│   ├── gateway/              # 📨 网关核心逻辑 (WebSocket/HTTP Hub)
│   └── proto/                # 📝 Protobuf 协议定义 (Protocol Buffers)
│
├── src/                      # 🎨 前端 UI 源码 (Vue 3 + Tailwind CSS)
│   ├── api/                  # 📡 前端 API 封装 (Frontend API Layer)
│   ├── components/           # 🧱 UI 组件库 (Avatar, IDE, Chat, etc.)
│   ├── views/                # 🖼️ 页面视图 (Dashboard, WorkMode, Pet3D)
│   └── utils/                # 🛠️ 工具函数 (Utilities)
│
└── resources/                # 📦 打包资源 (Icons, Pre-configs, Binaries)

💬 Social Mode

让 Pero 走出桌面,进入你的群聊。

通过集成 NapCat (OneBot v11) 协议,PeroCore 实现了深度社交模式,让 AI 能够像真实用户一样在 QQ 群和私聊中互动。

1. 深度上下文记忆

  • 全场景感知:不仅能记住与你的私聊,还能感知群聊中的复杂人际关系。她会根据每个人的昵称、历史发言风格和互动频率,建立差异化的好感度与认知。
  • 长短期缓冲:系统内置 SocialSessionManager,支持消息缓冲区(Buffer)处理。在热闹的群聊中不会死板地逐条回复,而是会观察一段时间后,对多条消息进行综合理解后再进行插话或回应。

2. 状态驱动的交互逻辑

  • 潜水与活跃:AI 拥有自己的“社交能量”。她会根据群聊的热闹程度自动切换状态。
    • 活跃模式:当有人直接 @ 或触发关键词时,AI 会实时响应并进入互动期。
    • 观察模式:在平时,她会保持静默潜水,仅在后台进行语义分析,并随机选择时机进行吐槽或参与讨论。
  • 秘书层决策:在正式调用大模型生成回复前,会经过一层轻量级的“决策过滤”,判断当前是否真的需要说话,从而避免 AI 变成复读机或刷屏机器。

3. 社交日报与成长

  • 回忆总结:自动回顾当日的所有社交记录,生成一份社交日报。AI 会以日记的形式记录下今天认识了谁、发生了什么趣事,这些总结将永久沉淀为她的长期记忆,影响她未来的性格演变。
  • 好友申请处理:具备智能好友申请识别,能够根据申请理由自动判断是否通过,并进行初步的自我介绍。

🐳 Docker

"Always online, always there."

PeroCore 支持通过 Docker 部署在 NAS、Linux 服务器或云主机上,提供 24/7 的 AI 伴侣服务。

核心能力

  • API 服务: 提供标准 HTTP/WebSocket API,供移动端或 Web 端调用。
  • 社交分身: 集成 NapCat,自动登录 QQ 并在群聊中活跃。
  • 数据漫游: 通过 Gateway,你的记忆数据可以在桌面端与移动端之间无缝同步。

部署指南

# 1. 下载 Docker 配置文件
git clone https://github.com/YoKONCy/PeroCore.git
cd PeroCore

# 2. 启动服务 (Backend + Gateway + NapCat)
docker-compose up -d

🚀 Quick Start

1. 桌面用户 (Windows)

最简单的体验方式。

  1. 下载最新 Release 包。
  2. 解压到非中文路径。
  3. 双击运行 PeroLauncher.exe
    • 自动拉起 Python 后端与 Electron 前端。
    • 内置 Ollama / Local LLM 配置引导。

2. 开发者 (源码运行)

# 1. 克隆仓库
git clone https://github.com/YoKONCy/PeroCore.git
cd PeroCore

# 2. 后端准备 (Python 3.10+)
cd backend
pip install -r requirements.txt
python main.py  # 启动后端服务

# 3. 前端启动 (Node.js 18+)
# 新开一个终端
npm install
npm run dev:electron     # 启动 Electron 开发模式

💖 Non-Profit & Community

NonProfit

PeroCore 是一个完全非盈利的开源项目。

我们是一群热爱 AI、热爱二次元、热爱技术的开发者。我们开发 PeroCore 不是为了商业变现,仅仅是因为: 我们想要一个真正的、懂我们的桌面伙伴。

  • 永久免费: 核心代码永久开源,不设任何付费墙。
  • 社区驱动: 欢迎任何形式的贡献——无论是代码 (PR)、建议 (Issue) 还是单纯的喜爱 (Star)。

创造者: YoKONCy
核心成员: Tripo


🌟 Star History

Star History Chart


For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for PeroCore

Similar Open Source Tools

For similar tasks

For similar jobs