Metadata-Version: 2.4
Name: dyao-hippocortex
Version: 3.0.2
Summary: 一个模拟人类大脑结构的开源AI桌宠助手
License-File: LICENSE
Keywords: ai,brain-simulation,neural-network,assistant,desktop-pet
Author: Yao Deng
Author-email: 2250111005@stu.hzcu.edu.cn
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Utilities
Requires-Dist: chardet (>=7.0.0)
Requires-Dist: diffusers (>=0.20.0)
Requires-Dist: faiss-cpu (>=1.14.0)
Requires-Dist: ipykernel (>=7.0.0)
Requires-Dist: ipython (>=8.0.0)
Requires-Dist: jieba (>=0.42.0)
Requires-Dist: langchain (>=0.2.0)
Requires-Dist: langchain-community (>=0.2.0)
Requires-Dist: langchain-core (>=0.2.0)
Requires-Dist: langchain-ollama (>=0.1.0)
Requires-Dist: langchain-text-splitters (>=0.2.0)
Requires-Dist: loguru (>=0.7.0)
Requires-Dist: matplotlib (>=3.8.0)
Requires-Dist: numpy (>=1.26.0)
Requires-Dist: pandas (>=2.0.0)
Requires-Dist: pillow (>=10.0.0)
Requires-Dist: pydantic (>=2.0.0)
Requires-Dist: pydantic-settings (>=2.0.0)
Requires-Dist: pygments (>=2.0.0)
Requires-Dist: pyqt5 (>=5.15.0)
Requires-Dist: python-dotenv (>=1.0.0)
Requires-Dist: scikit-learn (>=1.0.0)
Requires-Dist: scipy (>=1.11.0)
Requires-Dist: seaborn (>=0.13.0)
Requires-Dist: torch (>=2.0.0)
Requires-Dist: tqdm (>=4.66.0)
Requires-Dist: transformers (>=4.34.0)
Project-URL: Repository, https://github.com/a123547879/HippoCortex
Description-Content-Type: text/markdown

# 🧠 HippoCortex - 类脑AI桌宠助手

一个模拟人类大脑结构的开源AI桌宠助手，拥有自主意识、长期记忆和学习能力。

## ✨ 核心特性

- 🧠 **类脑认知架构**：模拟人脑海马体-皮层分工，多专家分区处理不同类型知识
- 💾 **长期记忆系统**：支持短期→长期→永久记忆分级，自然遗忘与睡眠巩固
- ⚡ **赫布学习机制**：遵循"共同激活，连接强化"原则，越用越聪明
- 🌙 **睡眠记忆巩固**：自动修剪无效突触，强化核心记忆，生成梦境
- 💬 **主动交互能力**：会主动说话、分享想法、提问，不是被动问答机器
- 🎨 **图文多模态**：支持图片理解和视觉想象，能"看到"并"想象"画面
- 📚 **自主学习能力**：会自己读书学习，不断增长知识
- 📊 **脑状态可视化**：实时显示疲劳度、记忆数、突触连接热力图

## 🚀 快速开始

### 前置要求
- Python 3.11+
- [Ollama](https://ollama.com/) 已安装并运行

### 安装
```bash
pip install hippocortex

运行
bash
运行
hippocortex
首次运行
程序会自动下载所需的 AI 模型：
gemma3:4b - 大语言模型
bge-m3 - 向量嵌入模型
🎮 使用说明
基本交互
点击桌宠头像打开聊天窗口
可以发送文字和图片
桌宠会根据对话内容学习和记忆
核心功能
聊天：自然语言对话，支持上下文理解
睡眠：点击 "睡眠" 按钮，让 AI 休息并巩固记忆
学习：AI 会在空闲时自动读书学习
走神：AI 空闲时会进入走神状态，回忆和联想记忆
分析：右键菜单可以分析大脑突触连接热力图
🧠 大脑状态说明
表格
状态	说明
🧠 大脑已唤醒	正常工作状态
🌙 走神中...	正在回忆和联想记忆
💬 有话想对你说...	有主动意图要表达
🌙 睡眠巩固中...	正在睡眠，整理记忆
❌ 思考失败	遇到错误
🛠️ 开发
本地运行
bash
运行
git clone https://github.com/a123547879/HippoCortex.git
cd HippoCortex
pip install -r requirements.txt
cd src
python MainTest5.py
项目结构
plaintext
hippocortex/
├── core/              # 核心认知模块
│   ├── BrainCore.py   # 大脑核心
│   ├── Hippocampus.py # 海马体
│   └── Cortex.py      # 大脑皮层
├── experts/           # 多专家系统
│   ├── ConceptExpert.py
│   ├── SpatialExpert.py
│   ├── AbstractExpert.py
│   └── VisualExpert.py
├── services/          # 服务模块
│   ├── IntentionService.py
│   ├── MindWanderingService.py
│   └── BookReadingService.py
├── ui/                # 用户界面
│   └── brain_pet_window.py
└── main.py            # 程序入口
