Skip to content

GRright/MindPeek

Repository files navigation

MindPeek - AI 用户画像引擎

MindPeek Logo

Python Vue License LangGraph

让 AI 真正读懂人心

English | 中文 | 日本語


✨ 核心亮点

👤 智能用户画像

MindPeek 通过 LLM 深度解析对话,自动构建持续进化的个人画像:

特征维度 说明
性格特质 MBTI、大五人格分析
行为习惯 生活习惯、决策模式
兴趣爱好 娱乐偏好、学习方向
价值观 人生观、世界观
情感状态 当前情绪、心理需求
社会关系 人际网络、互动模式

🔮 AI 行为预测

基于用户画像,预测用户未来的行为和想法:

  • 行为预测:用户可能采取的行动
  • 想法预测:用户可能产生的思考
  • 情感预测:用户可能出现的情绪
  • 决策预测:用户可能做出的选择

💬 个性化对话

AI 会根据你的画像提供贴心回复:

  • 自然融入你的兴趣和习惯
  • 根据你的性格调整语气风格
  • 预判你的需求并主动建议
  • 像老朋友一样自然对话

🖼️ 效果展示

聊天界面
聊天界面
智能思考
智能对话*
特征管理
特征管理
特征图谱
特征图谱
用户画像1
用户画像
用户画像2
行为预测

* 用户对话时会根据已提取的用户画像信息进行个性化的回答,图中已根据用户居住在上海,性格较为内向等之前已经提取到的用户特征信息进行深度思考,使得输出答案更贴近用户实际。


🚀 快速开始

1. 安装依赖

pip install -r requirements.txt
cd frontend
npm install

2. 配置系统

copy config\config.example.json config\config.json

编辑 config/config.json,只需填写以下配置:

{
    "llm_providers": {
        "openai": {
            "api_url": "你的 LLM API URL",
            "api_key": "你的 API Key",
            "model": "模型名称 如 Qwen-3.5"
        }
    },
    "default_provider": "openai",
    "memo_base": {
        "project_url": "你的 MemoBase 地址",
        "api_key": "你的 MemoBase API 密钥"
    }
}

必要配置说明

  • llm_providers:LLM 服务配置,必须填写才能正常使用对话功能
    • api_url:LLM API 接口地址
    • api_key:API 访问密钥
    • model:使用的模型名称
  • memo_base:MemoBase 数据库配置(初次使用可前往 https://app.memobase.io/dashboard/projects 创建项目得到project_url和api_key,免费额度足够基本使用)
    • project_url:MemoBase 项目地址
    • api_key:MemoBase API 密钥

其他配置项(如 feature_extractionagent 等)可使用默认值。

3. 启动服务

python -m uvicorn main:app --host 0.0.0.0 --port 8000
cd frontend
npm run dev

4. 开始使用

5. 快速测试(推荐)

运行交互式测试脚本,快速体验完整功能:

python tests/interactive_conversation_test.py

该脚本将自动:

  • 发送 30 轮模拟对话
  • 自动提取用户特征(MBTI、兴趣爱好、价值观等)
  • 生成用户画像和知识图谱
  • 触发智能提醒和画像趋势分析

测试完成后,访问以下页面查看结果:


📊 系统架构

MindPeek 系统架构


🛠️ 技术栈

层级 技术
后端 FastAPI + LangGraph + SQLAlchemy
前端 Vue 3 + Element Plus + ECharts
AI OpenAI 兼容接口 + Sentence Transformers
存储 SQLite + MemoBase 云同步

⚡ 系统特性

👤 智能用户画像构建

  • 深度对话解析:通过持续对话自动提取用户特征
  • 多维度画像:涵盖性格、兴趣、价值观、情感状态等
  • 持续进化:用户画像随对话不断更新和完善
  • Agents原理:深入了解 Agent 系统的协作机制

🎨 响应式界面设计

  • 桌面端:完整功能展示,左右分栏布局
  • 移动端:自适应优化,核心功能优先
  • 人性化交互:智能滚动,不打断用户阅读

🔔 智能情绪提醒

  • 实时情绪监测:自动识别负面情绪状态
  • 及时健康预警:发现异常时主动提醒
  • 个性化建议:根据用户情况提供关怀

🔗 可视化特征图谱

  • 知识图谱展示:直观呈现特征之间的关联
  • 特征分布图表:可视化展示用户画像构成
  • 可交互探索:点击查看详细特征信息

📁 项目结构

MindPeek/
├── backend/
│   ├── agents/           # Agent 智能体核心模块
│   │   ├── agent_engine.py        # 多Agent分析引擎(MBTI等)
│   │   ├── chat_graph.py          # LangGraph 聊天流程
│   │   ├── feature_discovery.py    # 特征发现Agent
│   │   ├── intent_classifier.py   # 意图分类器
│   │   ├── personal_info_agent.py # 个人信息提取Agent
│   │   ├── prediction_agent.py    # 行为预测Agent
│   │   └── async_orchestrator.py  # 异步任务编排器
│   ├── services/         # 服务层
│   │   ├── profile_service.py     # 用户画像服务
│   │   ├── llm_provider.py        # LLM提供者(支持多种模型)
│   │   ├── feature_merger.py      # 特征合并服务
│   │   └── memo_base_service.py   # MemoBase云同步
│   ├── knowledge_graph/  # 知识图谱(心理学知识库)
│   │   └── graph.py
│   ├── models/           # 数据模型
│   │   ├── database.py            # SQLAlchemy模型
│   │   └── schemas.py            # Pydantic模式
│   ├── api/              # API路由
│   │   └── routes.py
│   └── core/             # 核心配置
│       └── config.py
├── frontend/              # Vue 3 前端
│   └── src/
│       ├── views/                 # 页面视图
│       │   ├── ChatView.vue       # 聊天页面
│       │   ├── ProfileView.vue    # 用户画像页面
│       │   ├── FeaturesView.vue   # 特征管理页面
│       │   └── KnowledgeGraphView.vue  # 知识图谱页面
│       ├── components/            # 组件
│       ├── stores/                # 状态管理
│       ├── api/                   # API调用
│       └── router/                # 路由配置
└── config/                # 配置文件

📜 License

GNU General Public License v3.0


MindPeek - 让 AI 真正理解你

About

🧠 MindPeek | 让 AI 真正读懂人心 告别传统用户画像方法! MindPeek 通过 LLM 深度解析,从每轮对话中自动提取性格、偏好、潜在需求——构建持续进化的个人画像。 ✨ 核心能力 • 多维度特征提取:性格特点 / 价值观 / 潜在想法 / 情感状态等 • 多 Agent 协作架构:自我进化,越用越懂你 懂用户的 AI,从这里开始。

Topics

Resources

License

Stars

2 stars

Watchers

2 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors